home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 09 Application Software / ACE15-D.SFX / ace15.doc < prev   
Text File  |  1995-12-17  |  95KB  |  1,816 lines
  1. ┴├┼-128/64 ╒╙┼╥'╙ ╟╒╔─┼  FOR ╥ELEASE #15   [─ECEMBER 17, 1995]
  2. ------------------------------------------------------------------------------
  3. 1. ╔╬╘╥╧─╒├╘╔╧╬
  4.  
  5. ┴├┼ IS AN OPERATING SYSTEM FOR THE ├OMMODORE 128 AND ├OMMODORE 64 THAT
  6. PROVIDES A ╒NIX-LIKE COMMAND-SHELL ENVIRONMENT.  ┴LL ┴├┼ PROGRAMS WILL RUN
  7. ON EITHER A ├128 (IN 128 MODE) OR A ├64.  ┬╘╫, "┴├┼" MEANS "┴DVANCED
  8. ├OMPUTING ┼NVIRONMENT" (WELL, ADVANCED FOR THE 128/64).
  9.  
  10. ╘HIS RELEASE CONTAINS THE FOLLOWING IMPROVEMENTS OVER THE PREVIOUS RELEASE:
  11.  
  12.  - ╘HE ┌┼─ TEXT EDITOR HAS BEEN RE-IMPLEMENTED FOR THE ┴├┼ ENVIRONMENT.  ╘HE
  13.    EDITOR IS NOT AS COMPLETE AS THE STAND-ALONE VERSION OF THE PROGRAM FOR
  14.    THE ├128, BUT THE GAP IS BEING CLOSED.  ╘HE ┴├┼ VERSION SUPPORTS THE
  15.    REGULAR CURSOR MOVEMENT KEYS, TEXT INSERT AND DELETE, RANGE INSERT AND
  16.    DELETE, AND GLOBAL SEARCHING.  ╘HE ┴├┼ VERSION ALSO SUPPORTS AN UNLIMITED
  17.    LINE LENGTH WITH WORD-PROCESSOR-LIKE TEXT "SLOSHING" AND AUTO-WRAPPING
  18.    WITH "SOFT RETURNS".  ╔N FACT, FOR ALL INTENTS AND PURPOSES, IT *IS* A
  19.    WORD PROCESSOR (IT JUST DOESN'T HAVE A PRINT FORMATTER... YET).  ┴ND, OF
  20.    COURSE, IT TAKES ADVANTAGE OF THE ┴├┼ ENVIRONMENT TO MAKE USE OF ╥┴═╠INK
  21.    ─┴├├ MEMORY AND TO RUN ON THE ├OMMODORE 64.
  22.  
  23.    ╒NFORTUNATELY, ╔ DIDN'T GET AROUND TO IMPLEMENTING ALL OF THE FEATURES
  24.    THAT ╔ WANTED FOR THIS RELEASE, MOST NOTABLY MARK (├╘-═), DELETE (├╘-─),
  25.    RECALL (├╘-╥), SET-HUNT-STRING (├╘-╚), AND FIND (├╘-╞).  ╔ WILL BE MAKING
  26.    AN INTERIM RELEASE OF THE PROGRAM BY ITSELF ONCE ╔ HAVE THESE FEATURES
  27.    IMPLEMENTED.
  28.  
  29.    ┴LSO, LIKE THE STAND-ALONE VERSION, THIS VERSION HAS THE BUG THAT IT DOES
  30.    NOT HANDLE THE CONDITION OF RUNNING OUT OF MEMORY PROPERLY.  ╔ INTEND TO
  31.    HANDLE THIS GRACEFULLY IN THE FUTURE, BUT FOR NOW, IF ┌┼─ RUNS OUT OF
  32.    MEMORY, THEN IT WILL ABORT BACK THE COMMAND SHELL AND YOU WILL LOSE ANY
  33.    CHANGES YOU HAVE MADE TO YOUR DOCUMENT.  ┘OU ONLY HAVE TO BE CONCERNED
  34.    ABOUT THIS IF THE "╞:" (FREE) NUMBER DIPS BELOW ABOUT 1024.  ╔F IT EVER
  35.    HITS 0, THEN YOU ARE IN IMMANENT DANGER.  ╒SING THE DEFAULT CONFIGURATION
  36.    ON THE UNEXPANDED ├64 RESULTS IN A MERE 256 BYTES BEING REPORTED AS FREE
  37.    (ALTHOUGH THERE ARE "UNSEEN" BYTES, ABOUT 8╦, IN THE APPLICATION SPACE
  38.    THAT AREN'T REPORTED).  ┌┼─ WILL RUN ON AN UNEXPANDED ├64, BUT IT WILL
  39.    PROBABLY NOT BE VERY USABLE.  ╘O GET A LITTLE MORE SPACE, YOU CAN REMOVE
  40.    THE COMMAND SHELL FROM THE RAMDISK AND DISABLE THE SOFT-80 SCREEN IN THE
  41.    CONFIGURATION.
  42.  
  43.  - ╘HE ┴├┼ ASSEMBLER HAS BEEN IMPROVED TO HANDLE "INCLUDE" FILES, TO
  44.    ACCEPT MORE NUMERIC-EXPRESSION OPERATORS, AND TO MAKE IT MORE COMPATIBLE
  45.    WITH SOURCE CODE FOR OTHER ASSEMBLERS.  ╞ILE INCLUSION CAN GO ARBITRARILY
  46.    DEEP (LIMITED TO 9 OR SO OPEN FILES AT A TIME FOR ├OMMODORE ╦ERNAL
  47.    DEVICES).  ├OMPATIBILITY FEATURES INCLUDE THE ABILITY TO ACCEPT OPCODES
  48.    AND DIRECTIVES IN BOTH UPPERCASE AND LOWERCASE, TO ACCEPT LABEL
  49.    DEFINITIONS WITHOUT THE TRAILING COLON, TO ACCEPT THE "/" CHARACTER TO
  50.    MEAN "+-" FOR RELATIVE LABELS, TO USE THE STANDARD DIRECTIVES ".BYTE",
  51.    ".WORD", ETC.  (THE OLD "DB", "DW", ETC. ALIASES HAVE BEEN DROPPED), AND
  52.    TO ACCEPT THE ┬UDDY/OTHER DIRECTIVES ".SEQ", ".OBJ", ".ASC", ".BYT", AND
  53.    ".END".
  54.  
  55.  - ╙UPPORT HAS BEEN ADDED TO THE ├128 ┴├┼ KERNEL FOR 115.2KBPS WITH A HACKED
  56.    ╙WIFT╠INK CARTRIDGE.  ╘HE ╙WIFT╠INK NORMALLY COMES WITH A DOUBLE-SPEED
  57.    CLOCK CRYSTAL TO GIVE YOU A MAXIMUM SPEED OF 38.4KBPS, BUT IF YOU REPLACE
  58.    THIS WITH A STANDARD-SPEED CRYSTAL (1.8432 ═╚Z), THEN THE TOP SPEED OF
  59.    115.2KBPS CAN BE USED.  ╬OTE THAT YOU SACRIFICE THE ABILITY TO USE
  60.    38.4KBPS AND THE NEXT LOWER SPEED IS 19.2KBPS, PLUS YOU VOID ANY
  61.    WARRANTY.  ╘HE TERMINAL PROGRAM HAS A MINOR CHANGE TO SUPPORT THE NEW
  62.    BAUD RATE, AND WITH 115.2KBPS, ╔ HAVE DOWNLOADED 4832 CPS USING ╞╪ WITH
  63.    MY 28.8KBPS MODEM FOR A LARGE TEXT FILE (├= ╚ACKING MAGAZINE ╔SSUE #4).
  64.  
  65.  - ┴ NUMBER OF NEW FONTS ARE PROVIDED, INCLUDING WIDE, SHORT, AND NORMAL
  66.    ╬OVATERM SOFT-80 FONTS AND ┴╬╙╔-GRAPHICS (STANDARD ╔┬═-╨├, ╔ DON'T KNOW
  67.    WHAT CODE PAGE) FONTS.
  68.  
  69.  - ╘HE USER-PORT DEVICE DRIVER HAS BEEN EXTENDED TO USE EITHER THE ╨├2 LINE
  70.    (FOR COMPUTERS) OR THE ╨┴2 LINE (FOR PRINTERS) FOR HANDSHAKING IN ITS
  71.    "RAW"-MODE OUTPUT.  (╘HE ╟┼╧CABLE IS MIS-DESIGNED TO USE THE ╨┴2 LINE
  72.    RATHER THAN THE ╨├2 LINE FOR SIGNALLING DATA-READY TO THE PRINTER).  ╔N
  73.    ADDITION TO RAW MODE WITH ╨├2/╨┴2, THERE IS ALSO A "PACKET" MODE WITH
  74.    ╨├2/╨┴2.
  75.  
  76.  - ╘HE ┴├┼ KERNEL INTERFACE HAS BEEN REORGANIZED, PLUS A FEW NEW FEATURES
  77.    HAVE BEEN IMPLEMENTED, INCLUDING FASTER SOFT-80 FIELD FILLING, MOUSE
  78.    SUPPORT AND MORE-POWERFUL GRAPHICS SUPPORT.  ┴ TEST PROGRAM "MOUSETEST"
  79.    IS PROVIDED, WHICH ALLOWS YOU TO MOVE A POINTER AROUND A HIRES SCREEN
  80.    WITH A MOUSE IN PORT #1.  ═ORE ABILITY TO MANIPULATE THE CHARACTER SET
  81.    HAS ALSO BEEN IMPLEMENTED.  ╙EE THE ┴├┼ ╨ROGRAMMER'S ╥EFERENCE ╟UIDE FOR
  82.    MORE DETAILS.  ╘HE "JIFFY" RATE ON THE ╨┴╠ ├64 HAS BEEN CHANGED TO 60 ╚Z,
  83.    BUT IT IS STILL 50 ╚Z ON ╨┴╠ ├128S FOR TECHNICAL REASONS.  ╔ WILL TRY TO
  84.    FIX THIS NEXT TIME.
  85.  
  86.  - ╙OME BUGS HAVE BEEN FIXED UP, INCLUDING ONE IN THE "FX" CLIENT PROGRAM
  87.    THAT CAUSED PROBLEMS IN THE 7-BIT MODE.  ╘HE USER-PORT DRIVER HAD A BUG
  88.    IN CLOSING RAW-MODE CHANNELS.  ┴LSO, THANKS TO ╟EOFF ╙ULLIVAN, ╔ NOW HAVE
  89.    MY OWN GEO├ABLE AND HAVE TESTED THE USER-PORT PRINTING CODE.  ┬UT,
  90.    UNFORTUNATELY, THERE SEEMS TO BE A BUG WHEN PRINTING GRAPHICS WITH VBMPR
  91.    OVER THIS PORT; IT APPEARS TO SOMETIMES PRINT TOO FEW GRAPHICS CHARACTERS
  92.    WHICH CAUSES THE PRINTER TO GET OUT OF SYNCH WITH THE GRAPHICS DATA.
  93.    ┴LSO, THERE SEEMS TO BE A PROBLEM WITH THE ╬╧ ╙├╥╧╠╠ KEY NOT DOING
  94.    ANYTHING, THAT ╔ DON'T HAVE TIME TO INVESTIGATE RIGHT NOW.
  95.  
  96. ╘HIS DISTRIBUTION CONSISTS OF THE FOLLOWING FILES.  ╙YSTEM FILES:
  97.  
  98. ACE              - THE KERNEL BOOTSTRAPPER; RUNNABLE FROM EITHER 64 OR 128 MODE
  99. ACE128           - THE KERNEL FOR THE ├128
  100. ACE64            - THE KERNEL FOR THE ├64
  101. CONFIG           - THE CONFIGURATION-INITIALIZER PROGRAM
  102. .ACERC           - THE SYSTEM CONFIGURATION - THIS IS DATA, NOT AN EXECUTABLE
  103. CONFIG.EDIT      - CONFIGURATION-EDITOR PROGRAM (WRITTEN IN ┬┴╙╔├)
  104. ACECHR-STANDARD  - STANDARD ┴├┼ CHARACTER SET (SPECIAL GRAPHIC CHARACTERS)
  105. ACECHR-COMMODORE - REGULAR ├OMMODORE CHARACTER SET
  106. ACECHR-ISO-ACE   - ╔╙╧ 8859-1 CHARACTER SET, WITH ┴├┼ 4-BIT IMAGES
  107. ACECHR-ISO-NOVA  - ╔╙╧ 8859-1 CHARACTER SET, WITH ╬OVATERM 4-BIT IMAGES
  108. ACECHR-ISO-WIDE  - ╔╙╧ 8859-1 CHARACTER SET, WITH ╬OVATERM-"╫IDE" 4-BIT IMAGES
  109. ACECHR-ISO-SHORT - ╔╙╧ 8859-1 CHARACTER SET, WITH ╬OVATERM-"╙HORT" 4-BIT IMAGES
  110. ACECHR-ANSI-ACE  - ┴╬╙╔ CHARACTER SET, WITH ┴├┼ 4-BIT IMAGES
  111. ACECHR-ANSI-NOVA - ┴╬╙╔ CHARACTER SET, WITH ╬OVATERM 4-BIT IMAGES
  112. ACECHR-ANSI-WIDE - ┴╬╙╔ CHARACTER SET, WITH ╬OVATERM-"╫IDE" 4-BIT IMAGES
  113. ACECHR-ANS-SHORT - ┴╬╙╔ CHARACTER SET, WITH ╬OVATERM-"╙HORT" 4-BIT IMAGES
  114. ACECHR-ANS-PERRY - ┴╬╙╔ CHARACTER SET, WITH "╨ERRYFONT" :-) 4-BIT IMAGES
  115. ACEKEY-QWERTY    - REGULAR QWERTY KEY MATRIX (ALSO BUILT IN)
  116. ACEKEY-DVORAK    - ─VORAK KEY MATRIX
  117. SH               - THE COMMAND SHELL (REALLY, AN APPLICATION PROG)
  118. .ASHRC           - THE ┴├┼-COMMAND-SHELL AUTO-EXECUTION SHELL SCRIPT
  119.  
  120. ┴PPLICATION PROGRAMS (EXPLAINED IN ╙ECTION 6.3):
  121.  
  122. CP          - COPY FILES
  123. RM          - REMOVE FILES (SCRATCH)
  124. MV          - RENAME FILES (NAMED FOR ╒NIX "MV"=="MOVE")
  125. MKDIR       - CREATE A NEW DIRECTORY (FLAT NAME)
  126. RMDIR       - REMOVE AN EXISTING EMPTY DIRECTORY (FLAT NAME)
  127. WC          - COUNT WORDS, LINES, CHARACTERS OF FILES
  128. GREP        - SEARCH FOR A SUBSTRING IN FILES (FROM ╒NIX "GREP")
  129. TR          - TRANSLATE FROM ONE CHARACTER SET TO ANOTHER
  130. SORT        - SORT LINES OF FILES
  131. WRAP        - WRAP LINES LONGER THAN 75 CHARACTERS
  132. DATE        - DISPLAY CURRENT DATE AND TIME
  133. FORTY       - SWITCH TO 40-COL SCREEN, SLOW MODE
  134. EIGHTY      - SWITCH TO 80-COL SCREEN, FAST MODE ON 128, OR SOFT-80 ON 64
  135. READ        - READ FILES (FOR TESTING)
  136. MEM         - DISPLAY AVAILABLE DYNAMIC AND TRANSIENT-PROGRAM-AREA MEMORY
  137. HELLO       - DUMB LITTLE "HELLO WORLD" EXAMPLE PROGRAM
  138. WINDOW      - SET THE CURRENT WINDOW DIMENSIONS
  139. ACECHR      - CHARACTERSET LOADER
  140. KEYMAT      - KEY-MATRIX LOADER
  141. HEAD        - DISPLAY THE FIRST ╬ LINES OF A FILE, DONATED BY ╩AKE ╚AMBY
  142. JIF         - DISPLAY THE CURRENT JIFFY-CLOCK TIME
  143. MOUSETEST   - MOUSE/GRAPHICS DEMO PROGRAM
  144.  
  145. MORE        - FULL-SCREEN FILE VIEWER
  146. UUENCODE    - ENCODE FILES INTO UUENCODED FORMAT
  147. UUDECODE    - DECODE FILES FROM UUENCODED FORMAT
  148. BCODE       - ENCODE FILES INTO ┬├╧─┼ FORMAT
  149. UNBCODE     - DECODE FILES FROM ┬├╧─┼ FORMAT
  150. CRC32       - DISPLAY ├╥├-32 *┬* VALUES FOR FILES (NEW STANDARD)
  151. CRC32A      - DISPLAY ├╥├-32 *┴* VALUES FOR FILES (OLD STANDARD)
  152. KAR         - ╦┴╥ (╦EVIN'S ┴╥CHIVER) FILE ARCHIVER (ALL-TEXT FORMAT)
  153. UNKAR       - ╦┴╥ (╦EVIN'S ┴╥CHIVER) FILE DEARCHIVER
  154. VBM         - ╓┬═ BITMAP-FILE VIEWER
  155. VBMPR       - ╓┬═ BITMAP-FILE (V2 ONLY) PRINTER FOR ┼PSON-COMPATIBLE PRINTERS
  156. AS          - ONE-PASS ASSEMBLER
  157. TERM        - SIMPLE ╓╘-100 TERMINAL-EMULATION PROGRAM
  158. FX          - CUSTOM ╞ILE E╪CHANGE (UPLOAD/DOWNLOAD) PROGRAM
  159. Z           - ┌┼─ TEXT EDITOR
  160.  
  161. ╘HESE BINARY PROGRAMS ARE SUPPLIED IN ┬├╧─┼D ARCHIVE FORMAT, IN TWO SEPARATE
  162. FILES: ONE FOR SYSTEM FILES AND ONE FOR APPLICATION FILES (ONE FILE WOULD BE
  163. TOO BIG FOR SOME SYSTEMS).  ╘HE "UNBCODE" PROGRAM INCLUDED HERE WILL DECODE
  164. THIS FORMAT OF ARCHIVE, BUT THIS IS A ├ATCH-22, SO YOU WILL HAVE TO EITHER USE
  165. A PREVIOUS RELEASE OF ┴├┼ TO DECODE THIS RELEASE, OR YOU'LL HAVE TO GET THE
  166. ├-LANGUAGE "UNBCODE" PROGRAM FOR ╒NIX AND ═╙-─╧╙.  ╔ USED TO DISTRIBUTE THE
  167. BINARIES IN UUENCODED FORMAT, BUT ╔ HAVE SWITCHED TO ┬├╧─┼ FORMAT SO THAT
  168. PEOPLE WILL NOT ACCIDENTALLY CORRUPT THEIR DOWNLOADS (AND FOR POLITICAL
  169. REASONS).  ╘HE FILES MAY ALSO BE AVAILABLE IN ".╙╞╪" FORMAT TOO, SOMETIME.  ╔N
  170. THE FUTURE, ╔ MAY BE MAKING DISTRIBUTIONS IN ".├╙╪" (├RAIG'S ╙ELF-E╪TRACTING)
  171. FORMAT, WHICH, OF COURSE, WILL BE TECHNOLOGICALLY SUPERIOR TO ".╙╞╪".
  172.  
  173. ╬OTE THAT THE "ACE128" AND "ACE64" PROGRAMS ARE FUNCTIONALLY IDENTICAL,
  174. EXCEPT THAT ONE IS SET UP FOR THE 128 AND THE OTHER FOR THE 64.  ╘HUS, ALL
  175. OF THE APPICATION BINARY PROGRAMS WILL WORK WITH EITHER "ACE128" OR
  176. "ACE64".  ╠╧┴─ AND ╥╒╬ THE "ACE" PROGRAM AND IT WILL LOAD THE CORRECT
  177. "KERNEL" FOR YOUR COMPUTER.  ╧R, YOU CAN CHANGE THE FIRST LINE OF THE "ACE"
  178. PROGRAM TO LOAD A DIFFERENT SYSTEM CONFIGURATION AND SAVE IT WITH A NAME
  179. LIKE "ACE-BIGMEM" OR SOMETHING, AND RUN THAT WHEN YOU WANT TO USE THE
  180. ALTERNATE SYSTEM CONFIGURATION.
  181.  
  182. ╘HE ┬UDDY- AND ┴├┼ASSEMBLER SOURCE CODE FILES ARE ALSO PUBLICLY AVAILABLE IN
  183. ".╦┴╥" FORMAT.  ═OST SMALLER PROGRAMS ARE IN ┬UDDY FORMAT (EXCEPT FOR THE
  184. KERNEL ITSELF) AND MOST BIGGER PROGRAMS ARE IN THE ┴├┼ASSEMBLER FORMAT.
  185. ┘OU SHOULD NOTE THAT, WITH THE EXCEPTION OF CONDITIONAL AND MACRO ASSEMBLY,
  186. ┴├┼ASSEMBLER FORMAT IS PRETTY MUCH A SUPERSET OF ┬UDDY FORMAT.  ╙EE THE
  187. "ACE╬╬-FILES.DOC" DOCUMENTATION FILE FOR A LIST OF THE VARIOUS FILES THAT
  188. ARE AVAILABLE.
  189. ------------------------------------------------------------------------------
  190. 2. ╒╙╔╬╟ ╘╚┼ ╙┘╙╘┼═
  191.  
  192. ╫HEN ┴├┼ STARTS, IT LOADS AND EXECUTES THE COMMAND SHELL (AMONG OTHER THINGS),
  193. GIVES YOU A PROMPT AND WAITS FOR YOU TO GIVE IT A COMMAND.  ┴ COMMAND HAS THE
  194. FOLLOWING FORMAT:
  195.  
  196. PROGRAMNAME ARG1 ARG2 ... ARG╬
  197.  
  198. ╘HE PROGRAMNAME CAN BE ANY OF THE FOLLOWING BUILT-IN COMMANDS (COVERED IN
  199. ╙ECTION 6.1):
  200.  
  201. ECHO       - PRINT THE GIVEN ARGUMENTS TO STDOUT
  202. CLEAR      - CLEAR THE SCREEN
  203. CLS        - SAME AS "CLEAR"
  204. DIR        - CLEAR THE SCREEN AND GIVE A LONG-FORM DIRECTORY LISTING
  205. D          - SAME AS "DIRECTORY", BUT NO CLEAR SCREEN
  206. LS         - GIVE A MULTI-COLUMN SHORT-FORM DIRECTORY LISTING
  207. CLSL       - COMBINATION OF "CLS" AND "LS"
  208. CD         - CHANGE THE CURRENT WORKING DEVICE/DIRECTORY
  209. CAT        - DISPLAY THE NAMED FILES TO STDOUT
  210. EXIT       - EXIT FROM THE COMMAND SHELL (PERHAPS BACK TO ┬┴╙╔├)
  211. X          - SAME AS "EXIT"
  212. DOS        - GIVE A ├OMMODORE DOS COMMAND TO THE CURRENT DEVICE (╧╨┼╬1,DV,15..)
  213. @          - SAME AS "DOS"
  214. PATH       - SET THE PATH TO SEARCH FOR EXTERNAL PROGRAMS
  215. SH         - INVOKE THE SHELL AGAIN AS A SUB-SHELL
  216.  
  217. OR PROGRAMNAME CAN BE FOR ANY OF THE EXTERNAL PROGRAMS PROVIDED WITH THIS
  218. DISTRIBUTION.  ┘OU'LL HAVE TO FORGIVE MY PERSONAL TASTE IN COMMAND NAMES AND
  219. ABBREVIATIONS (UNTIL THE "ALIAS" SHELL FEATURE IS FINALLY IMPLEMENTED).
  220.  
  221. 2.1. ╔╬╨╒╘/╧╒╘╨╒╘ ╥┼─╔╥┼├╘╔╧╬
  222.  
  223. ╘HE THREE ╒NIX STANDARD FILES ARE SUPPORTED:
  224.  
  225. STDIN    - WHERE THE DEFAULT INPUT COMES FROM (USUALLY THE KEYBOARD)
  226. STDOUT   - WHERE THE DEFAULT OUTPUT GOES TO (USUALLY THE SCREEN)
  227. STDERR   - WHERE ERROR MESSAGES ARE SENT TO (USUALLY THE SCREEN)
  228.  
  229. ╘O TEMPORARALLY REDIRECT THESE STANDARD FILE STREAMS FOR THE EXECUTION OF A
  230. COMMAND, YOU CAN USE THE FOLLOWING INCANTATIONS ON A COMMAND LINE:
  231.  
  232. <INFILE     - REDIRECT STDIN - INPUT TAKEN FROM "INFILE"
  233. >OUTFILE    - REDIRECT STDOUT - OUTPUT PUT INTO FILE "OUTFILE"
  234. >>OUTFILE   - REDIRECT STDOUT - SAME AS ">" BUT THE OUTPUT IS APPENDED TO FILE
  235. >&ERRFILE   - REDIRECT STDERR - ERROR OUTPUT IS PUT INTO "ERRFILE"
  236. >>&ERRFILE  - REDIRECT STDERR - ERROR OUTPUT IS APPENDED TO FILE "ERRFILE"
  237.  
  238. ─O NOT PUT A SPACE BETWEEN THE REDIRECTION SYMBOL(S) AND THE FILE NAME.
  239.  
  240. 2.2. ╨┴╘╚╬┴═┼╙
  241.  
  242. ╫HENEVER YOU SPECIFY A FILE, YOU USE A "PATHNAME".  ╨ATHNAMES HAVE THE
  243. FOLLOWING OPTIONAL PARTS:
  244.  
  245. [DEVICE:][RAMLINK-DIRECTORY:][FILENAME]
  246.  
  247. ─EVICE NAMES ARE SET BY THE USER IN THE CONFIGURATION FILE, BUT THE FACTORY
  248. DEFAULTS ARE:
  249.  
  250. "A:"  - ├OMMODORE DISK DEVICE #8 - INPUT/OUTPUT
  251. "B:"  - ├OMMODORE DISK DEVICE #9 - FOR IF YOU HAVE >1 DRIVE
  252. ....  - ├OMMODORE DISK DEVICES #10 TO #16
  253. "J:"  - ├OMMODORE DISK DEVICE #17 - A DISK DRIVE
  254. "K:"  - ├USTOM DEVICE DRIVER: THE KEYBOARD (OR SCREEN)
  255. "M:"  - ├USTOM DEVICE DRIVER: ╥AMDISK
  256. "N:"  - ├USTOM DEVICE DRIVER: "NULL" DEVICE
  257. "P:"  - ├OMMODORE DEVICE #4 - THE PRINTER, WITH ╙EC┴DDR 7 - OUTPUT ONLY
  258. "Q:"  - ├OMMODORE DEVICE #4 - THE PRINTER, WITH ╙EC┴DDR 5 - TRANSPARENT MODE
  259. "S:"  - ├USTOM DEVICE DRIVER: THE SCREEN (OR KEYBOARD)
  260. "U:"  - ├USTOM DEVICE DRIVER: USER-PORT INTER-MACHINE NETWORK/PAR-PRINT CABLE
  261. "X:"  - ├USTOM DEVICE DRIVER: MODEM ("TO THE E╪TERNAL WORLD") (╙WIFT╠INK-232)
  262. "Z:"  - ├USTOM DEVICE DRIVER: ╥AMDISK - INTENDED FOR STORING EXECUTABLES
  263. ".:"  - THE "CURRENT" DISK DEVICE
  264.  
  265. ├═─ ╥┴═╠INK (OR ├═─ ╚ARD─RIVE) DIRECTORY NAMES HAVE THE FOLLOWING FORMATS:
  266.  
  267. //DIR/:            - A SUBDIRECTORY OF THE ROOT DIRECTORY
  268. /DIR/:             - A SUBDIRECTORY OF THE CURRENT DIRECTORY
  269. 4//DIR/DIR/DIR/:   - A SUB-PATH OF THE ROOT DIRECTORY OF PARTITION #4
  270. /DIR/DIR/DIR/:     - A SUB-PATH OF THE CURRENT DIRECTORY
  271.  
  272. ┴ND FILENAMES HAVE THE USUAL ├OMMODORE FORMAT OF 1 TO 16 CHARACTERS.
  273.  
  274. ╘HUS, THE FOLLOWING ARE VALID PATHNAMES FOR FILES:
  275.  
  276. K:                   - THE KEYBOARD FOR INPUT
  277. P:                   - THE PRINTER FOR OUTPUT
  278. B:FILE1              - "FILE1" ON DISK DEVICE #9
  279. .:FILE1              - "FILE1" ON THE CURRENT DISK DEVICE
  280. FILE1                - "FILE1" ON THE CURRENT DISK DEVICE
  281. /DIR1/:FILE1         - "FILE1" IN THE ╥AM╠INK SUBDIRECTORY "DIR1", CUR. DEVICE
  282. A://DIR1/DIR2/:FILE1 - "FILE1" IN THE ╥AM╠INK SUBDIR "//DIR1/DIR2", DEVICE #8
  283.  
  284. ┴ND THE FOLLOWING ARE VALID PATHNAMES FOR DIRECTORIES:
  285.  
  286. A:             - DISK DEVICE #8 CURRENT DIRECTORY
  287. .:             - CURRENT DISK DEVICE'S CURRENT DIRECTORY      
  288. .://DIR1/:     - "DIR1" OFF THE ROOT DIRECTORY OF THE CURRENT ╥AM╠INK DEVICE
  289. /DIR1/DIR2/:   - SUBDIRECTORY "/DIR1/DIR2" OF THE CURRENT ╥AM╠INK DEVICE
  290.  
  291. ╬OTE THAT A DIRECTORY NAME ALWAYS ENDS WITH A ":".
  292.  
  293. ┘OU MAY APPEND A ",P" OR ",S" OR ",U" TO A FILENAME TO SPECIFY WHETHER A
  294. ╨╥╟, ╙┼╤, OR ╒╙╥ FILE SHOULD BE ACCESSED/CREATED.  ┬Y DEFAULT, ┴├┼ WILL
  295. CREATE ╙┼╤ FILES.
  296.  
  297. ┬╘╫, TO GENERATE AN ┼╧╞ FOR KEYBOARD INPUT, SIMPLY PRESS ├ONTROL-─.  ╧NLY DO
  298. THIS AT THE BEGINNING OF A BLANK LINE.
  299.  
  300. 2.3. ├╧══┴╬─-╙╚┼╠╠ ┴╥╟╒═┼╬╘╙
  301.  
  302. ┴RGUMENTS THAT CONTAIN SPACES MUST BE PUT INTO QUOTES.  ═ULTIPLE QUOTED
  303. STRINGS CAN BE PLACED SIDE-BY-SIDE TO PRODUCE A LONGER STRING.  ╘HE
  304. FOLLOWING ARE EXAMPLES OF VALID COMMAND-SHELL ARGUMENTS:
  305.  
  306. HELLO                                  -  HELLO
  307. 'HELLO'                                -  HELLO
  308. "HELLO THERE"                          -  HELLO THERE
  309. 'HELLO THERE'                          -  HELLO THERE
  310. 'SHE SAID, "HOW'"'S THAT"'"'' TO ME.'  -  SHE SAID, "HOW'S THAT" TO ME.
  311.  
  312. ├OMMAND SHELL ARGUMENTS ARE SEPARATED BY SPACES OR TAB CHARACTERS.
  313.  
  314. 2.4. ┼╪╘┼╥╬┴╠-├╧══┴╬─ ╙┼┴╥├╚ ╨┴╘╚
  315.  
  316. ╘HE "PATH" COMMAND SETS OR DISPLAYS THE CURRENT SEARCH PATHNAMES FOR
  317. EXTERNAL PROGRAMS.  ┬Y DEFAULT THE PATHS TO SEARCH ARE "Z:" AND "A:".  ╘HE
  318. PATH CONSISTS OF MULTIPLE DIRECTORY NAMES TO BE CHECKED, IN ORDER, FOR EACH
  319. BINARY EXECUTABLE OR SHELL SCRIPT THAT YOU GIVE THAT DOES NOT HAVE A
  320. PATHNAME PREFIX.
  321.  
  322. 2.5. ╫╔╠─├┴╥─╙
  323.  
  324. ╒NIX-STYLE WILDCARD EXPANSION IS SUPPORTED.  ╫HEN YOU ENTER AN ARGUMENT WITH
  325. AN ASTERISK IN THE FILENAME COMPONENT OF THE PATHNAME, THE COMMAND SHELL
  326. WILL AUTOMATICALLY EXPAND THAT NAME INTO AN ARGUMENT FOR EACH FILE IN THE
  327. SPECIFIED DIRECTORY THAT MATCHES THAT PATTERN.  ╘HE EXPANDED ARGUMENTS ARE
  328. THEN PASSED ONTO THE COMMAND YOU ARE INVOKING AS IF YOU HAD TYPED THEM ALL
  329. IN YOURSELF.  ╞OR EXAMPLE:
  330.  
  331. ┴╥╟╒═┼╬╘            ┼╪╨┴╬╙╔╧╬
  332. --------            ---------
  333. *                   FILE1 PROG1,P PROG2,P
  334. CH*                 CHESS,P CHINESE_CHECKERS,P
  335. *.BIN               MAIN.BIN,P DATA.BIN ANAGRAM.BIN
  336. A*N                 ANAGRAM.BIN AN ANOTHER_PLAN
  337. B:*.BIN             B:MAIN.BIN,P B:DATA.BIN B:ANAGRAM.BIN
  338. C://GAMES/:A*.BIN   C://GAMES/:ACROBAT.BIN,P C://GAMES/:ACRODATA.BIN
  339.  
  340. ┘OU'LL NOTE THAT PROGRAM FILES ARE EXPANDED TO INCLUDE A ",P".  ╔F A PATTERN
  341. DOES NOT EXPAND TO ANYTHING, AN ERROR MESSAGE IS DISPLAYED AND THE SHELL
  342. COMMAND IS NOT EXECUTED.  ┘OU'LL HAVE TO CURSOR-UP AND CHANGE THE COMMAND.
  343. ┘OUR FILENAME PATTERN CAN INCLUDE ONLY ONE ASTERISK (ANYWHERE IN THE NAME).
  344.  
  345. ╙OME EXAMPLE USES OF WILDCARD EXPANSION WITH THE PROVIDED UTILITIES FOLLOW:
  346.  
  347. CP B:* A:
  348. CP //GAMES/C64/:CHESS*.BIN SOMEFILE B://GAMES/:
  349. WC *.ASM *.C
  350. ------------------------------------------------------------------------------
  351. 3. ╙┘╙╘┼═ ├╧╬╞╔╟╒╥┴╘╔╧╬
  352.  
  353. ╘HE PROGRAM ENTITLED "CONFIG.EDIT" IS USED FOR EDITING THE SYSTEM
  354. CONFIGURATION.  ╘HE SYSTEM WILL BE CONFIGURED ACCORDING TO THE DATA IN THE
  355. FILE ".ACERC" EVERY TIME IT STARTS UP.  ╬OTE THAT ".ACERC" IS A LOADABLE
  356. BINARY ╨╥╟ FILE; IT IS NOT IN TEXT FORMAT AND IS NOT MEANT TO BE EDITED WITH A
  357. TEXT EDITOR.
  358.  
  359. ╘HE FOLLOWING DATA IS INCLUDED IN THE ".ACERC" FILE:
  360.  
  361. ╧╞╞  ╙╔┌  ─┼╙├
  362. ---  ---  ----
  363. $00  128  DEVICE DESCRIPTORS, 32 ENTRIES OF FOUR BYTES EACH.
  364.           [╞OR EACH ENTRY, OFFSETS: 0=DEVICE DRIVER TYPE, 1=DEVICE ADDRESS,
  365.            2=SECONDARY ADDRESS, 3=FLAGS.  ─ESCRIBED FURTHER BELOW.]
  366. $80    1  RAMLINK DEVICE NUMBER
  367.           [╘HE KERNEL DEVICE NUMBER OF YOUR ╥┴═╠INK.  ╘HE DEFAULT ╥╠ DEVICE
  368.            NUMBER IS 16.]
  369. $81    1  RAMLINK LAST LOGICAL BANK ALLOWED TO USE PLUS ONE (NORM 255)
  370.           [╞OR THE ╥┴═╠INK MEMORY PARTITION (NEXT SECTION), THE MAXIMUM
  371.            NUMBER OF 64╦ CHUNKS THAT CAN BE USED FOR DYNAMIC MEMORY.]
  372. $82    4  REAL-TIME CLOCK DEVICES TO CHECK [4], 255=UNUSED, 254=╙MART╫ATCH
  373.           [╘HESE ARE THE KERNEL DEVICE NUMBERS OF ├═─ DISK DRIVE UNITS THAT
  374.            HAVE A BUILT-IN REAL-TIME CLOCK TO CHECK FOR THE CURRENT TIME.  ╔F
  375.            THE FIRST ENTRY FAILS, THEN THE SECOND WILL BE TRIED, ETC., UNTIL
  376.            THE FOURTH ENTRY IS TRIED.  ╔F ALL DEVICES FAIL TO RETURN A TIME,
  377.            THEN THE DEFAULT DATE IS USED (NEXT).  ┴ VALUE OF 255 IN AN ENTRY
  378.            MEANS TO TRY THE NEXT ENTRY.  ┴ VALUE OF 254 IN AN ENTRY MEANS TO
  379.            TRY TO READ THE TIME FROM THE ╙MART╫ATCH DEVICE PLUGGED INTO
  380.            JOYSTICK PORT #1.  ┴├┼ USES THE ╘╧─ CLOCK OF ├╔┴#1 TO KEEP TIME.
  381.            ╘HE DATE IS STORED IN A REGULAR MEMORY FIELD AND IS NOT ROLLED ON
  382.            A 24-HOUR ╘╧─ CLOCK WRAP-AROUND.]
  383. $86    1  SCREEN SAVER ACTIVATION TIME, IN MINUTES (NORM 10)
  384.           [╘HE SCREEN WILL GO BLACK WHEN THE SCREEN SAVER IS ACTIVATED, AFTER
  385.            A PERIOD WHERE YOU HAVE NOT PRESSED ANY KEY FOR THE SPECIFIED TIME,
  386.            UNTIL YOU PRESS A KEY (INCLUDING THE ANY OF THE SHIFT KEYS).  ╔F
  387.            YOU PRESS ANY CHARACTER KEY, THAT KEY WILL APPEAR IN YOUR INPUT.
  388.            ╬ORMAL PROCESSING WILL CONTINUE IN THE BACKGROUND, WHILE THE SCREEN
  389.            SAVER IS ACTIVE, INCLUDING PRINTING TO THE SCREEN.  ╘HIS TIME IS IN
  390.            MINUTES.  ┴ VALUE OF ZERO MEANS TO DISABLE THE SCREEN SAVER.  ╘HE
  391.            SCREEN SAVER IS NOW ACTIVE FOR THE 40-COLUMN AND 80-COLUMN
  392.            DISPLAYS.]
  393. $87    1  ╥╘╙ ASSERTION-TO-MODEM-ACCEPTANCE DELAY PERIOD (NORM. 40)
  394.           [╘HIS VALUE GIVES A "FUDGE FACTOR" FOR THE ╙WIFT╠INK DRIVER FOR
  395.            CONTROLLING THE HARDWARE FLOW CONTROL.  ╙INCE ├OMMODORE COMPUTERS
  396.            CANNOT DO DISK ╔/╧ AND PROCESS ╙WIFT╠INK INTERRUPTS AT THE SAME
  397.            TIME, IT IS NECESSARY TO TURN INTERRUPTS OFF DURING ╔/╧.  ╘HIS
  398.            MEANS THAT IF MORE THAN ONE CHARACTER SHOWS UP WHILE INTERRUPTS
  399.            ARE DISABLED, THEN DATA WILL BE LOST.  ╘HE FUDGE FACTOR IS THE
  400.            PERIOD THAT ┴├┼ DELAYS BETWEEN ASSERTING THE ╥╘╙ FLOW-CONTROL
  401.            SIGNAL AND DISABLING INTERRUPTS.  ╘HE VALUE HAS NO PARTICULAR
  402.            MEANING, JUST THE NUMBER OF TIMES THAT A PARTICULAR BUSY-WAITING
  403.            LOOP IN THE ╙╠ DRIVER IS EXECUTED.  ╔F YOU ARE LOSING OCCASIONAL
  404.            CHARACTERS DURING BUFFER CAPTURING IN THE TERMINAL PROGRAM AND
  405.            YOU HAVE THE MODEM CONFIGURED PROPERLY FOR ╥╘╙/├╘╙ FLOW CONTROL,
  406.            THEN YOU MIGHT TRY INCREASING THIS VALUE TO SEE IF THAT SOLVES
  407.            THE PROBLEM.  ╫ITH MY ╒╙╥ 28.8 MODEM, A VALUE OF 10 WORKS JUST
  408.            FINE, BUT ╔'VE FUDGED THE FUDGE TO BE SAFE HERE.]
  409. $90   12  DEFAULT DATE AND TIME ┘┘:┘┘:══:──:╚╚:══:╙╙:╘╘:╘╫:╟╟:GG:┴┴
  410.           [╘HE DEFAULT DATE TO USE IF ATTEMPTS TO ACCESS THE CURRENT TIME
  411.            FROM ├═─ DISK DEVICES/╙MART╫ATCH FAIL.  ╞ORMAT IS 24-HOUR ┬├─.
  412.            ┴LL FOUR DIGITS OF THE YEAR ARE GIVEN.  ╘HE "╘╘" FIELD IS WHERE
  413.            YOU PUT THE _HUNDREDTHS_ OF SECONDS (I.E., THE TENTHS GO INTO THE
  414.            UPPER DIGIT).  ╘HE "╘╫" FIELD IS WHERE YOU PUT THE DAY OF THE
  415.            WEEK: 0 MEANS ╙UNDAY, 1 MEANS ═ONDAY, ..., 6 MEANS ╙ATURDAY, AND
  416.            7 MEAND "UNKNOWN".  ╘HE "╟╟" FIELD IS WHERE YOU PUT THE NUMBER OF
  417.            HOURS THAT YOUR TIME ZONE IS OFF FROM ╟═╘.  ╬EGATIVE VALUES ARE
  418.            ENTERED BY ADDING 80 TO THE NUMBER OF HOURS (SETTING THE HIGH BIT
  419.            OF THE ┬├─ VALUE).  ╞OR EXAMPLE, ┼─╘ (WHERE ╔ AM) IS OFF BY -4
  420.            HOURS FROM ╟═╘, SO ╔ WOULD ENTER 84.  ┴ VALUE OF 99 MEANS
  421.            "UNKNOWN".  ╘HE "GG" FIELD IS WHERE YOU ENTER THE NUMBER OF
  422.            MINUTES YOU ARE OFF FROM ╟═╘, IF YOU ARE NOT OFF BY AN EVEN
  423.            NUMBER OF HOURS.  ╘HIS IS ALWAYS A POSITIVE VALUE.  ╘HE "┴┴"
  424.            FIELD IS WHERE YOU ENTER THE ACCURACY OF YOUR CLOCK WITH RESPECT
  425.            TO THE ACTUAL REAL TIME.  ╘HESE TIME-ZONE/ACCURACY FIELDS ARE
  426.            USED EVEN IF YOU PULL THE TIME FROM A ├═─/╙MART╫ATCH DEVICE, SO
  427.            SET THE ACCURACY ACCORDING TO WHERE THE TIME WILL USUALLY
  428.            COME FROM.  ╘HE ACCURACY WILL BE INTERPRETED AS 2^┴┴ IN
  429.            MILLISECONDS, SO A VALUE OF 10 WOULD MEAN +/- ABOUT A SECOND.  ┴
  430.            VALUE OF 99 MEANS "UNKNOWN".  ╧R, IF YOU DON'T WANT TO BOTHER,
  431.            IT'S NOT REALLY VERY IMPORTANT THAT YOU FILL THIS TIMEZONE/
  432.            ACCURACY INFORMATION IN.  ╘HE FACTORY-SET VALUE OF THIS FIELD
  433.            IS 12AM, ╙UNDAY, ╩AN 1, 1995., WITH UNKNOWN TIMEZONE AND
  434.            ACCURACY.]
  435. $9├    4  ╙TRING: NAME OF YOUR TIME ZONE: UP TO THREE CHARS PLUS NULL
  436.           [╘HIS IS ADDED JUST FOR OFFICIALNESS.  ╘HE DEFAULT VALUE IS "╪╪╪",
  437.            WHICH MEANS 'UNKNOWN'.]
  438. $┴0    1  ├128 BANK1 START FREE PAGE (NORM $04)
  439.           [╘HIS FIELD AND THE NEXT DEFINE THE PAGES OF ╥┴═1 THAT ┴├┼ IS ALLOWED
  440.            TO USE.  ╘HIS MUST INCLUDE AT LEAST ONE PAGE.]
  441. $┴1    1  ├128 BANK1 LAST FREE PAGE PLUS ONE (NORM $FF)
  442. $┴2    1  ├128 EXPANDED INTERNAL MEMORY TYPE
  443.           [╬OT CURRENTLY USED.]
  444. $┴3    1  ├128 BANK0 LAST ALLOWED FREE PAGE PLUS ONE (NORM $FF)
  445.           [╘HIS IS THE HIGHEST PAGE, PLUS ONE, ON ╥┴═0 THAT ┴├┼ IS ALLOWED TO
  446.            USE.  ┘OU CAN SET THIS TO PROTECT A PROGRAM THAT YOU WISH TO
  447.            ATTEMPT TO USE WITH ┴├┼ (GOOD LUCK).  ╘HERE IS NO MINIMUM PAGE THAT
  448.            ┴├┼ IS ALLOWED TO USE; IT TAKES WHATEVER IT WANTS BELOW $6000.]
  449. $┴4    1  ├64 SOFT-80 NON-╥┼╒ _MINIMUM_ PRESCROLL AMOUNT (NORM 5)
  450.           [╘HIS WILL MAKE IT SO THAT EACH "WRITE" SYSTEM CALL THAT PRINTS DATA
  451.            TO THE SCREEN THAT CAUSES THE SCREEN TO SCROLL WILL MAKE THE SCREEN
  452.            SCROLL BY AT THE GIVEN NUMBER OF LINES, EVEN IF THERE ISN'T ENOUGH
  453.            DATA TO FILL THE SCROLLED-UP NUMBER OF LINES.  ╘HIS MAKES THE
  454.            SCROLLING ACTION A LITTLE UGLIER BUT ╬ TIMES MORE EFFICIENT FOR
  455.            PROGRAMS THAT PRINT DATA ONE LINE AT A TIME, LIKE "LS".]
  456. $┴5    1  ├128 LAST INTERNAL BANK ALLOWED TO USE ABOVE 2, PLUS ONE (NORM 8)
  457.           [╞OR EXPANDED INTERNAL MEMORY (A LA ╘WIN├ITIES-128), THIS SETS THE
  458.            HIGH LIMIT ON THE BANKS THAT ┴├┼ IS ALLOWED TO USE.  ┴ VALUE OF 2
  459.            MEANS THAT ┴├┼ IS NOT ALLOWED TO USE IT AT ALL.  ╘HERE IS NO LOW
  460.            LIMIT ON THIS BECAUSE IT CAUSED TOO MANY PROGRAMMING PROBLEMS.]
  461. $┴6    1  ├128 FIRST ╥┼╒ BANK ALLOWED TO USE (NORM 0)
  462.           [╘HIS AND THE NEXT FIELD DEFINE THE MINIMUM AND MAXIMUM (PLUS ONE)
  463.            ╥┼╒ BANK NUMBERS THAT ┴├┼ IS ALLOWED TO USE.  ╔ INCLUDED A MINUMUM
  464.            BECAUSE OF PLEAS ABOUT ┌ED HAVING A MINIMUM.  ╔F YOU SET BOTH MIN
  465.            AND MAX TO $00, THEN ┴├┼ WILL LEAVE THE ╥┼╒ MEMORY ALONE.
  466.            ╧THERWISE, ┴├┼ WILL AUTO-DETECT HOW MUCH YOU HAVE AND WILL MAKE USE
  467.            OF AS MUCH ╥┼╒ MEMORY AS IT CAN (NOTE THE DEFAULT MAX IS 255).]
  468. $┴7    1  ├128 LAST ╥┼╒ BANK ALLOWED TO USE PLUS ONE (NORM 255)
  469. $┴8    1  ├128 TOP PAGE OF ╘╨┴ (STACK) (NORM $C0)
  470.           [╘HIS DEFINES THAT PAGE (PLUS ONE) OF THE TOP OF THE APPLICATION
  471.            PROGRAM AREA (╘╨┴).  ╘HE BOTTOM IS $6000, SO A TOP OF $├000 GIVES
  472.            APPS 24╦ TO PLAY AROUND IN.  $├0 IS THE MAXIMUM VALUE THIS FIELD
  473.            CAN HAVE, SINCE THE ├OMMODORE ╦ERNAL MUST (FOR THIS RELEASE) STAY
  474.            IN CONTEXT WHENEVER ┴├┼ IS IN USE.  ╘HE TOP OF THIS SPACE IS ALSO
  475.            USED AS THE "ARGUMENT STACK" FOR APPLICATIONS.]
  476. $┴9    1  ├128 ╓─├ DEFAULT NUMBER OF ROWS (NORM 25)
  477.           [╘HIS OPTION SELECTS THE NUMBER OF ROWS TO DISPLAY ON THE ╓─├ SCREEN
  478.            WHENEVER ┴├┼ STARTS UP OR WHENEVER A USER PROGRAM (LIKE "EIGHTY")
  479.            SAYS TO USE THE DEFAULT NUMBER OF DISPLAY ROWS.]
  480. $┴┴    1  ├128 ╓─├ NUMBER OF ╦BYTES OF VIDEO ╥┴═ (NORM 16)
  481.           [╫HAT IT SAYS.  ╓ALID VALUES FOR THIS OPTION ARE 16 AND 64.  ╘HERE
  482.            WILL BE NO PROBLEM IF YOUR MACHINE REALLY HAS 64╦ BUT YOU ONLY SAY
  483.            IT HAS 16╦.]
  484. $┴┬    1  ├64 SOFT-80 SCREEN MAXIMUM PRESCROLL FOR ╥┼╒-SUPPORTED SCROLLING
  485.           [╘HE MAXIMUM NUMBER OF LINES TO "PRESCROLL" THE SCREEN IF YOUR
  486.            PROGRAM MAKES THE "WRITE" SYSTEM CALL WITH MULTIPLE LINES WORTH OF
  487.            DATA TO DISPLAY ONTO THE SCREEN.  ╘HE CURSOR WILL ALWAYS END UP ON
  488.            THE BOTTOM LINE OF THE DISPLAY.  ╘HIS OPTION MAKES THE SCROLLING
  489.            A BIT JUMPIER BUT MUCH MORE EFFICIENT.  ╘HIS OPTION IS NORMALLY
  490.            SET TO 99, WHICH REALLY MEANS THE NUMBER OF LINES ON THE SCREEN.]
  491. $┴├    1  ├128 80-COL SCREEN MAXIMUM PRESCROLL
  492.           [╘HE MAXIMUM NUMBER OF LINES TO "PRESCROLL" THE SCREEN.  ╘HE
  493.            FACTORY-SET DEFAULT IS 99, WHICH REALLY MEANS THE NUMBER OF LINES
  494.            ON THE SCREEN.]
  495. $┴─    1  ├128 40-COL SCREEN MAXIMUM PRESCROLL
  496.           [╘HE MAXIMUM NUMBER OF LINES TO "PRESCROLL" THE SCREEN.  ╘HE
  497.            FACTORY-SET DEFAULT IS 99, WHICH REALLY MEANS THE NUMBER OF LINES
  498.            ON THE SCREEN.]
  499. $┴┼    1  ├64 SOFT-80 SCREEN MAXIMUM PRESCROLL FOR SOFTWARE SCROLLING
  500.           [╘HE MAXIMUM NUMBER OF LINES TO "PRESCROLL" THE SCREEN.  ╘HE
  501.            FACTORY-SET DEFAULT IS 99, WHICH REALLY MEANS THE NUMBER OF LINES
  502.            ON THE SCREEN.]
  503. $┴╞    1  ├64 40-COL SCREEN MAXIMUM PRESCROLL
  504.           [╘HE MAXIMUM NUMBER OF LINES TO "PRESCROLL" THE SCREEN.  ╘HE
  505.            FACTORY-SET DEFAULT IS 99, WHICH REALLY MEANS THE NUMBER OF LINES
  506.            ON THE SCREEN.]
  507. $┬0    8  ├128 80-COL SCREEN COLOR PALETTE: TABLE OF EIGHT ╥╟┬╔ CODES.
  508.           [╘HIS TABLE GIVES THE PALETTE OF COLORS TO BE USED BY ├128 80-COL
  509.            APPLICATIONS.  ╘HE MEANINGS OF THE VALUES STORED AT THE OFFSETS
  510.            ARE: 0=CHAR, 1=CURSOR, 2=STATUS, 3=SEPARATOR, 4=HIGHLIGHT, 5=ALERT,
  511.            6=BORDER, 7=SCREEN.  ╘HE CHAR, BORDER, AND SCREEN COLORS ARE USED
  512.            WHEN THE SCREEN DRIVER IS INITIALIZED.  ╘HE BORDER VALUE FOR THE
  513.            80-COL SCREEN IS CURRENTLY IGNORED.  ╬OTE THAT ╥╟┬╔ CODES ARE USED,
  514.            EVEN FOR THE ╓╔├ CHIP (FOR CONSISTENCY).  ╘HE FACTORY DEFAULTS FOR
  515.            CHAR, SCREEN, AND BORDER ARE LIGHT GREY ON BLACK FOR 80 AND LIGHT
  516.            GREEN ON DARK GREY WITH A MEDIUM GREY BORDER FOR THE 40 (PERHAPS A
  517.            BIT ICKY).  ╘HE OTHER VALUES ARE CHOSEN ACCORDINGLY.  ╘HE PALETTES
  518.            FOR THE OTHER DISPLAYS HAVE THE SAME STRUCTURE AS THIS ONE.]
  519. $┬8    8  ├128 40-COL COLOR PALETTE
  520. $├0    1  ├64 SOFT-80 ENABLE MASK (NORM %10100000)
  521.           [╘HE 128-BIT ALLOWS THE SOFT-80 SCREEN TO BE USED.  ┴LLOWING THE
  522.            SOFT-80 SCREEN COSTS 10╦ OF ╥┴═0 MEMORY ON THE ├64.  ╘HIS SOFTWARE-
  523.            IMPLEMENTED BITMAP 80-COLUMN SCREEN IS SUPPORTED ONLY ON THE ├64.
  524.            ╧N A ├128, USE THE REAL 80-COLUMN SCREEN.  ╔F THE SOFT-80 SCREEN IS
  525.            NOT ALLOWED, THEN THE 10╦ OF MEMORY IS MADE AVAILABLE FOR FAR
  526.            MEMORY USE (E.G., FOR RAMDISKS).  ╘HE 64-BIT SPECIFIES THAT THE
  527.            SOFT-80 SCREEN IS TO BE ENTERED BY DEFAULT WHEN ┴├┼ STARTS UP,
  528.            RATHER THAN THE 40-COL SCREEN.  ┘OU CAN SWITCH BETWEEN THE TWO
  529.            SCREENS BY USING THE "FORTY" AND "EIGHTY" PROGRAMS.  ╘HE 32-BIT
  530.            SPECIFIES THAT THE ╥┼╒ IS TO BE USED TO ASSIST IN SCROLLING THE
  531.            BITMAP SCREEN IF AN ╥┼╒ IS PRESENT.  ╘HE COST OF DOING THIS IS 7.5╦
  532.            OF ╥┼╒ MEMORY.  ╘HE BENEFIT IS THAT THE SCREEN WILL SCROLL SEVERAL
  533.            TIMES FASTER THAN IT WILL BY JUST USING THE MAIN PROCESSOR, WHICH
  534.            IS USED OTHERWISE.]
  535. $├1    1  ├64 LAST ALLOWED PAGE FREE PLUS ONE (NORM $FF)
  536.           [╘HIS GIVES THE TOP PAGE, PLUS ONE, THAT ┴├┼ IS ALLOWED TO USE ON
  537.            THE 64.  ─ON'T SET THIS LOWER THAN THE TOP OF THE ╘╨┴ AREA.]
  538. $├2    1  ├64 FIRST ╥┼╒ BANK ALLOWED TO USE (NORM $00)
  539.           [╠IKE THE ├128 SETTINGS, YOU CAN SET THE USAGE FOR THE ╥┼╒ MEMORY.]
  540. $├3    1  ├64 LAST ╥┼╒ BANK ALLOWED TO USE (NORM $FF)
  541. $├4    1  ├64 EXPANDED INTERNAL MEMORY TYPE
  542.           [╬OT CURRENTLY SUPPORTED.]
  543. $├5    1  ├64 END EXPANDED INTERNAL MEMORY BANKS PLUS ONE (NORM $04)
  544.           [╘HIS FIELD IS CURRENTLY IGNORED.]
  545. $├6    1  ├64 TOP PAGE OF ╘╨┴ (STACK) (NORM $A3)
  546.           [╘OP OF THE ╘╨┴ FOR THE 64.  ┘OU CAN SET THIS BETWEEN $61 AND $D0,
  547.            BUT BE SURE NOT TO COLLIDE WITH THE STUFF IN HIGH MEMORY (SEE THE
  548.            MEMORY MAP EARLIER IN THIS DOCUMENT).  ╔ SET THE DEFAULT HERE
  549.            LOWER THAN IT NEEDS TO BE SO THAT A STOCK ├64 WITH THE SOFT-80
  550.            SCREEN CONFIGURED WILL HAVE ENOUGH MEMORY TO LOAD THE COMMAND
  551.            SHELL ONTO THE RAMDISK.  ╔F YOU HAVE EXPANDED MEMORY, THEN YOU
  552.            SHOULD SET THIS TO $C0 TO GET MAXIMUM APPLICATION PERFORMANCE
  553.            (FROM BIGGER DATA BUFFERS).]
  554. $├7    1  ╓IDEO TYPE: ╬╘╙├ (0) OR ╨┴╠ (1) (DEFAULT: 0)
  555. $├8    1  KEY REPEAT DELAY (NORM 20)
  556.           [╘HE NUMBER OF JIFFIES BETWEEN WHEN YOU PRESS A KEY THE FIRST TIME
  557.            AND WHEN IT STARTS REPEATING.]
  558. $├9    1  KEY REPEAT RATE (NORM 3)
  559.           [╘HE NUMBER OF JIFFIES BETWEEN EACH REPEAT OF A KEY WHILE YOU ARE
  560.            HOLDING IT DOWN.]
  561. $├┴    1  CONSOLE COLOR ENABLE DEFAULT (NORM $80)
  562.           [╘HIS IS USED TO ENABLE WHAT IS NORMALLY PRINTED ON THE CONSOLE
  563.            SCREEN: CHARACTERS, COLORS, AND/OR ATTRIBUTES.  ┴LL APPLICATIONS
  564.            THAT NEED TO USE COLORS WILL ENABLE AND RESTORE THE CONSOLE
  565.            COLORS BY THEMSELVES, SO THERE IS NO NEED TO HAVE THEM ENABLED
  566.            ALL THE TIME.  ╘HE DEFAULT IS TO HAVE ONLY CHARACTERS ENABLED
  567.            (NOT COLORS/ATTRIBUTES) BECAUSE THIS ALLOWS IT TO OPERATE TWICE
  568.            AS QUICKLY FOR OPERATIONS LIKE SCROLLING.]
  569. $├┬    1  INPUT LINE SCROLLBACK BUFFER LINE COUNT (NORM 5)
  570.           [╘HE NUMBER OF PREVIOUS LINES TO SAVE SO THAT YOU CAN SCROLL BACK
  571.            THROUGH PREVIOUS INPUT LINES IN ORDER TO EDIT THEM.  ┼ACH LINE
  572.            OF BUFFER SPACE REQUIRES 256 BYTES OF FAR MEMORY TO STORE.
  573.            ┘OU ═╒╙╘ SPECIFY AT LEAST ONE LINE, OR THE SYSTEM WILL CRASH IN
  574.            ALL SORTS OF WEIRD AND WONDERFUL WAYS (THIS IS A BUG, NOT A
  575.            FEATURE).]
  576. $├├    1  CONTROLLER PORT 1 DEVICE
  577.           [╬OT CURRENTLY IMPLEMENTED.]
  578. $├─    1  CONTROLLER PORT 2 DEVICE
  579.           [╬OT CURRENTLY IMPLEMENTED.]
  580. $├┼    1  ├128 ╓─├ MAXIMUM NUMBER OF ROWS TO DISPLAY (NORM 51)
  581.           [╘HIS SETTING GIVES THE MAXIMUM NUMBER OF ROWS THAT YOU WANT YOUR
  582.            SCREEN TO DISPLAY.  ╙OME PROGRAMS WILL ASK FOR THIS MAXIMUM SETTING
  583.            (LIKE "EIGHTY 255").  ┘OU SHOULD SET THIS TO THE MAXIMUM NUMBER OF
  584.            (INTERLACED) LINES THAT WILL FIT ON YOUR DISPLAY.  ╘HE VALUE 51 IS
  585.            THE ABSOLUTE MAXIMUM: THE MAXIMUM THAT HARDWARE WILL SUPPORT.]
  586. $├╞    1  ├128 ╓─├ "CROSSOVER" NUMBER OF DISPLAY ROWS (NORM 28)
  587.           [╘HIS SETTING GIVES THE NUMBER OF ╓─├ DISPLAY ROWS WHICH WILL BE THE
  588.            LOWEST SETTING THAT WILL BE DISPLAYED IN INTERLACE MODE.  ╘HE
  589.            INTERLACE CHARACTERS ARE APPROXIMATELY HALF AS HIGH AS THE REGULAR
  590.            CHARACTERS, SO YOU WILL BE ABLE TO SEE MORE ON YOUR SCREEN.  ╘HE
  591.            FACTORY-SET DEFAULT IS PROBABLY GOOD FOR A ╘╓, BUT YOU CAN SEE
  592.            WHAT WORKS FOR YOU.  ╔ HAVE A 1902A MONITOR, AND ╔ CAN DISPLAY
  593.            30 LINES IN REGULAR CHARACTERS (THE MAXIMUM THE HARDWARE ALLOWS),
  594.            SO ╔ SET THE "CROSSOVER" VALUE TO 31 FOR MYSELF.  ╬OTE: ╔ DON'T
  595.            KNOW HOW WELL THESE INTERLACED CHARACTERS WILL WORK ON NON-╬╘╙├
  596.            MACHINES, OR ON NON-1902A'S, BUT YOU CAN TRY THEM FOR YOURSELF.
  597.            ╔F THEY DON'T WORK, THEN YOU CAN JUST SET THIS OPTION TO BE LARGER
  598.            THAN THE MAXIMUM NUMBER OF ╓─├ ROWS TO DISPLAY (PREVIOUS OPTION),
  599.            AND YOU'LL NEVER HAVE TO LOOK AT INTERLACED CHARACTERS.]
  600. $─0    8  ├64 80-COL COLOR PALETTE
  601.           [╞OR THE BITMAPPED HI-RES 80-COL SCREEN, WHICH IS NOT YET
  602.            IMPLEMENTED.]
  603. $─8    8  ├64 40-COL COLOR PALETTE
  604. $┼0    1  ╘HE ╥┴═╠INK-╥┴═ PARTITION NUMBER (NORM. 31)
  605.           [╙EE THE ─YNAMIC ═EMORY SECTION BELOW.]
  606. $┼1   13  ╙TRING: ╘HE ╥┴═╠INK-╥┴═ PARITION NAME (NORM. "RL-RAM")
  607. $┼┼    1  ╘HE ╥┴═╠INK-╔NDIRECT-╥┼╒ PARTITION NUMBER (NORM. 30)
  608. $┼╞   17  ╙TRING: ╥┴═╠INK-╔NDIRECT-╥┼╒ PARTITION NAME (NORM. "INDIRECT-REU")
  609. $100  32  INITIAL/HOME CURRENT DIRECTORY STRING (DEFAULT "A:")
  610.           [╔MMEDIATELY AFTER BOOTING AND BEFORE CALLING THE SHELL, THE KERNEL
  611.            WILL DO A CHANGE DIRECTORY TO THE NULL-TERMINATED STRING GIVEN
  612.            HERE.]
  613. $120  32  ╙TRING: USER-DEFINABLE KEYMATRIX FILE, OR NULL (NORM. "")
  614. $140  64  ╙TRING: DEFAULT EXECUTABLE SEARCH PATH (DEF. "Z:", "A:", ".:")
  615.           [╘HE PATHS TO USE TO SEARCH FOR EXECUTABLE PROGRAMS.  ┼ACH DIRECTORY
  616.            NAME IS A NULL-TERMINATED STRING, AND THE LIST OF PATHS IS
  617.            TERMINATED BY AN EMPTY STRING.]
  618. $180  64  ├ONFIGURATION-FILE SEARCH PATH (DEF. "Z:", "A:")
  619.           [╬OT CURRENTLY USED.]
  620. $1├0  32  ╘EMPORARY-FILE DIRECTORY NAME (DEF. ".:")
  621.           [╘HE DIRECTORY TO USE TO STORE INTERMEDIATE/TEMPORARY FILES.]
  622. $1┼0  32  ╬AME OF CHARACTER SET TO LOAD WHEN BOOTING UP (N."ACECHR-COMMODORE")
  623. $200   -  ╙╔┌┼
  624.  
  625. ╘HE OFFSETS FROM $00 TO $7╞ CONTAIN 32 FOUR-BYTE FIELDS, WHICH ARE USED TO
  626. DEFINE THE DEVICES IN THE SYSTEM.  ╘HESE FIELDS WILL CORRESPOND TO DEVICE
  627. NAMES "@:", "┴:", "┬:", ..., "┌:", "[:", "\:", "]:", "^:", AND "_:" (FORGIVE
  628. THE NON-LETTER DEVICE NAMES).  ╘HE FOUR FIELDS WILL BE DEFINED AS FOLLOWS:
  629.  
  630. 0 DEVICE DRIVER TYPE (0=╦ERNAL NON-DISK, 1=╦ERNAL DISK, 2=CONSOLE, 3=NULL,
  631.   4=RAMDISK, 5=USERPORT, 6=SWIFTLINK, 255=EMPTY)
  632. 1 DEVICE PRIMARY ADDRESS
  633.   (╙WIFT╠INK: ╔/╧ PAGE OF HARDWARE)
  634. 2 DEVICE SECONDARY ADDRESS
  635.   (╙WIFT╠INK: SIZE OF RECEIVE BUFFER IN PAGES)
  636. 3 FLAGS
  637.   (╦ERNAL─ISK: $80 FOR A DISK WILL MEANS THAT IT HAS A ├═─ ╥EAL-╘IME CLOCK)
  638.   (╒SER╨ORT: $00=USE RAW COMMUNICATION, $80=USE PACKET-ORIENTED COMMUNICATION,
  639.            $40=USE ╨┴2 RAW COMM (USE THIS W/╟┼╧CABLE), $├0=USE ╨┴2 PACKET COMM)
  640.   (╙WIFT╠INK: BELOW)
  641.  
  642. ╞OR THE SWIFTLINK DEVICE, THE "PRIMARY ADDRESS" FIELD CONTAINS THE ╔/╧ PAGE
  643. OF THE SWIFTLINK CHIP (NORMALLY $DE, BUT YOU CAN USE ANY PAGE YOU WANT).
  644. ╘HE "SECONDARD ADDRESS" FIELD SHOULD BE SET TO THE NUMBER OF PAGES THAT YOU
  645. WANT IN YOUR RECEIVE BUFFER.  ╘HE FACTORY-SET DEFAULT IS FOR ONE PAGE (256
  646. BYTES).  ╘HIS VALUE IS SELECTED TO CONSERVE MEMORY; YOU MAY BE HAPPIER WITH
  647. A VALUE OF 4 (MEANING 1024 BYTES) OR SO.  ╘HE MAXIMUM FOR THIS SETTING CAN
  648. BE TO THE POINT AT WHICH THE RECEIVE BUFFER CROSSES THE TRANSIENT-PROGRAM
  649. AREA (ABOUT 12╦ WITH THE STANDARD CONFIGURATION, LESS WITH A SOFT-80 ├64),
  650. AND THE MINIMUM SETTING IS FOR 1 PAGE.  ╘HE SIZE OF THIS VALUE DOESN'T
  651. MATTER WHEN YOU ARE USING 115.2KBPS, SINCE A SPECIAL, DEDICATED-PURPOSE,
  652. HIGH-SPEED 256-BYTE BUFFER IS USED THEN.
  653.  
  654. ╘HE "FLAGS" FIELD FOR THE SWIFTLINK SHOULD BE SET AS FOLLOWS.  ╘HE 128 BIT
  655. SHOULD BE SET TO "0" IF YOU WANT YOUR MODEM PARAMETERS TO BE "8╬1" OR SET TO
  656. "1" IF YOU WANT "7┼1".  ╬O OTHER WORD-LENGTH/PARITY/STOP-BITS SETTINGS ARE
  657. SUPPORTED.  ╘HE 64 BIT SHOULD BE SET TO "0" IF YOU HAVE A NORMAL (DOUBLE-
  658. SPEED) CLOCK CRYSTAL (WHAT ├═─ SHIPS) OR SET TO "1" IF YOU HAVE A HACKED
  659. (STANDARD-SPEED) CLOCK CRYSTAL (1.8432 ═╚Z).  ┘OU WILL ONLY BE ABLE TO GET
  660. 115.2KBPS IF YOU HAVE THIS HACK.  ╘HE LOWER FOUR BITS SHOULD BE SET TO
  661. SELECT THE BAUD RATE, ACCORDING TO THE FOLLOWING TABLE.  ╘HE FACTORY-SET
  662. DEFAULT IS TO 2400 BAUD WITH 8╬1 AND A NON-HACKED ╙WIFT╠INK ($08).
  663.  
  664. BITS   HEX   DEC      BAUD
  665. ----   ---   ---    ------
  666. 0000     0     0    UNUSED
  667. 0001     1     1        50
  668. 0010     2     2       110
  669. 0011     3     3       134.5
  670. 0100     4     4       300
  671. 0101     5     5       600
  672. 0110     6     6      1200
  673. 0111     7     7      1800
  674. 1000     8     8      2400
  675. 1001     9     9      4800
  676. 1010     A    10      7200
  677. 1011     B    11      9600
  678. 1100     C    12     19.2K
  679. 1101     D    13     38.4K
  680. 1110     E    14     57.6K   (NOT ACTUALLY SUPPORTED)
  681. 1111     F    15    115.2K   (ONLY AVAILABLE ON A ╞AST ├128 WITH HACKED ╙╠)
  682.  
  683. ╔F YOU DON'T WANT TO WASTE MEMORY ON ╙WIFT╠INK TRANSMIT AND RECEIVE BUFFERS
  684. IN YOUR CONFIGURATION, THEN JUST REMOVE THE DEVICE ENTRY FOR THE SWIFTLINK
  685. (NORMALLY DEVICE SLOT "X:") BY SETTING THE DEVICE TYPE TO 255 (EMPTY).  ┘OU
  686. DON'T HAVE TO WORRY ABOUT ANY MEMORY-BLEED PROBLEMS WITH THIS DEVICE, SINCE
  687. ┴├┼ WILL TOUCH ITS ╔/╧ REGISTERS AND INTIALIZE THE ╙WIFT╠INK CHIP ONLY IF
  688. YOU OPEN A FILE TO THE DEVICE DRIVER (I.E., USE THE "TERM" PROGRAM).
  689.  
  690. ╘O SPARE YOU THE AGONY OF EDITING THIS BINARY CONFIGURATION MANUALLY, THE
  691. ┬┴╙╔├ PROGRAM "CONFIG.EDIT" CAN BE USED INSTEAD.  ╥UN IT FROM ┬┴╙╔├, NOT
  692. FROM INSIDE OF ┴├┼.  ╔N FACT, YOU SHOULD RUN THIS BEFORE RUNNING ┴├┼ THE
  693. FIRST TIME TO SET UP THE CONFIGURATION.
  694.  
  695. ╘HE PROGRAM PROVIDES A FULL-SCREEN INTERFACE.  ═OVE THE CURSOR AMONG THE
  696. FIELDS ON EACH PAGE AND AMONG THE PAGES TO SET THE VALUES.  ┴LL VALUES ARE
  697. IN DECIMAL (EXCEPT THE STRINGS).  ╘HEN SAVE THE NEW CONFIGURATION, EXIT, AND
  698. RUN ┴├┼.  ╔F YOU SCREW UP THE NEW ".ACERC", THE PREVIOUS ONE WILL BE
  699. AVAILABLE IN ".ACERC.BAK".
  700. ------------------------------------------------------------------------------
  701. 4. ─┘╬┴═╔├ ═┼═╧╥┘
  702.  
  703. ┴FTER YOU HAVE CONFIGURED ┴├┼ FOR YOUR SYSTEM, IF YOU HAVE A ╥┴═╠INK, YOU
  704. WILL HAVE TO CONFIGURE IT FOR ┴├┼ IF YOU WANT TO USE ╥┴═╠INK ╥┴═ OR INDIRECT
  705. ╥┼╒ ACCESS.  ╘HE WAY THAT ┴├┼ DETECTS THESE TYPES OF MEMORY IS VIA THE
  706. ╥╠-─╧╙ PARTITION TABLE.  ╞OR ╥┴═╠INK ╥┴═, ┴├┼ WILL CHECK FOR PARTITION
  707. NUMBER 31 BEING A ╞OREIGN ═ODE (─IRECT ┴CCESS) PARTITION WITH THE NAME
  708. "RL-RAM".  (┘OU CAN CHANGE THE PARTITION NUMBER/NAME IN THE CONFIGURATION IF
  709. YOU WISH).  ╔F IT IS, THEN ┴├┼ WILL GET THE INFORMATION FOR THAT PARTITION
  710. TO DETERMINE THE SIZE AND START ADDRESS (IN ╥╠ MEMORY).  ╔T WILL THEN CHECK
  711. THE LIMIT FOR USAGE OF ╥╠-╥┴═ IN THE ".ACERC" FILE, AND ADJUST THE SIZE IT
  712. CAN USE ACCORDINGLY, BEFORE INITIALIZING THE MEMORY.  ╘O SET UP THIS
  713. PARTITION ON YOUR ╥┴═╠INK IN THE FIRST PLACE, REFER TO YOUR ╥┴═╠INK
  714. DOCUMENTATION AND USE THE TOOLS PROGRAM PROVIDED WITH IT.
  715.  
  716. ╒SING ╥┼╒ (╥AM ┼XPANSION ╒NIT) MEMORY WITH ┴├┼ IS PRETTY EASY; YOU JUST MAKE
  717. SURE IT IS PLUGGED INTO THE COMPUTER WHEN ┴├┼ IS STARTED.  ┴├┼ WILL AUTO-
  718. DETECT THE SIZE OF THE ╥┼╒ AND THEN CHECK THE CONFIGURATION FOR LIMITIATIONS
  719. ON ╥┼╒ USAGE.
  720.  
  721. ╔F YOU HAVE YOUR ╥┼╒ PLUGGED INTO YOUR ╥┴═╠INK IN THE ╥┴═ PORT (RATHER THAN
  722. THE PASS-THROUGH PORT), AND YOU HAVE THE ╬ORMAL/─IRECT SWITCH THROWN TO THE
  723. ╬ORMAL POSITION, THEN YOUR MACHINE CANNOT ACCESS ╥┼╒ MEMORY IN THE USUAL
  724. WAY.  ╘HE ONLY WAY TO ACCESS IT IS TO GO THROUGH THE ╥┴═╠INK.  ┴├┼ WILL LOOK
  725. FOR PARTITION NUMBER 30 BEING ─IRECT ┴CCESS AND NAMED "INDIRECT-REU" FOR
  726. THIS PURPOSE.  (┘OU CAN CHANGE THIS PARTITION NUMBER/NAME IN THE
  727. CONFIGURATION).  ╔F YOUR ╬ORMAL/─IRECT SWITCH IS IN THE ─IRECT POSITION,
  728. THEN ┴├┼ WILL USE THE ╥┼╒ DIRECTLY AND WILL IGNORE THE "INDIRECT-REU"
  729. PARTITION.  ─O NOT CHANGE THE POSITION OF THE ╬ORMAL/─IRECT SWITCH WHILE ┴├┼
  730. IS IN ACTION.
  731.  
  732. ╘HE TRICKY PART HERE IS IN CONFIGURING YOUR ╥┴═╠INK.  ┘OU HAVE TO MAKE SURE
  733. THAT THE MEMORY ALLOCATED TO THE "INDIRECT-REU" PARTITON IS THE MEMORY OF
  734. THE ╥┼╒.  ╥┴═╠INK MEMORY STARTS FROM $000000 AND GOES UP TO $╞╞╞╞╞╞.  ╥┼╒
  735. MEMORY WILL BE AT THE VERY FRONT OF THIS MEMORY (FROM ADDRESS $000000), AND
  736. THE INTERNAL ╥┴═╠INK MEMORY WILL FOLLOW IMMEDIATELY AFTER THIS.  ╞OR
  737. EXAMPLE, IF ╔ HAD A 512╦ ╥┼╒ AND AN 8 ═EG ╥┴═╠INK, MY ╥┼╒ MEMORY WOULD COVER
  738. ╥╠ ADDRESSES $000000-$07╞╞╞╞, AND MY INTERNAL ╥╠ MEMORY WOULD COVER ╥╠
  739. ADDRESSES $080000-$87╞╞╞╞.  ╫HEN PARTITIONING THE DEVICE, PARTITIONS ARE
  740. ASSIGNED MEMORY FROM LOWER ADDRESSES TO HIGHER ADDRESSES.  ╙O, STARTING WITH
  741. AN EMPTY ╥╠ (NO PARTITIONS), YOU MUST CREATE THE "INDIRECT-REU" PARTITION
  742. FIRST, FOLLOWED BY ANY ╥╠-─╧╙ PARTITIONS AND THE "RL-RAM" PARTITION.  ┘OU
  743. MUST ALSO MAKE SURE THAT THE "INDIRECT-REU" PARTITION IS THE SAME SIZE AS
  744. YOUR ╥┼╒.  512╦ IS 2048 BLOCKS.  ┴ NOTE FOR DELETING ╥╠ PARTITIONS: DELETE
  745. THE ONES THAT WERE LAST ALLOCATED FIRST.
  746.  
  747. ┘OU HAVE THE OPTION OF INSTALLING OR NOT INSTALLING EITHER OF THESE
  748. PARTITIONS.  ╔F EITHER IS MISSING, ┴├┼ WILL SIMPLY WORK WITHOUT IT.  ┘OU'LL
  749. WANT TO BE CAREFUL ABOUT THROWING THE ─IRECT SWITCH IF YOU DON'T HAVE YOUR
  750. ╥┼╒ "PROTECTED" WITH AN "INDIRECT-REU" PARTITION.  (╫ITH OTHER ╥┼╒
  751. APPLICATIONS ALSO).
  752.  
  753. ╘HE VARIOUS TYPES OF MEMORY GIVE THE FOLLOWING PERFORMANCE UNDER ┴├┼:
  754.  
  755. TYPE            BANDWIDTH   LATENCY
  756. -------------   ---------   -------
  757. ╥┼╒             1,007,641      65.8
  758. ╥┼╒ THRU ╥╠     1,007,641      77.8
  759. ╥┴═╠INK           105,792     199.2
  760. ╥╠ WITH ╥┼╒       372,827     319.8
  761. INTERNAL ╥┴═0     120,181      44.2
  762. INTERNAL ╥┴═1      80,283      56.3
  763.  
  764. ╘HE BANDWIDTH IS IN BYTES/SEC AND THE LATENCY IS IN SLOW TICKS
  765. (▐MICROSECONDS).  ╘O DETERMINE HOW MUCH TIME IT WILL TAKE TO PERFORM A
  766. SPECIFIC REQUEST, TAKE THE NUMBER OF BYTES YOU WANT TO TRANSFER AND DIVIDE
  767. IT BY THE BANDWIDTH, MULTIPLY THE RESULT BY 1,022,727 (╬╘╙├) AND ADD THE
  768. LATENCY.  ╘HIS WILL GIVE YOU THE TRANSFER TIME IN SLOW TICKS.
  769.  
  770. ╞OR THE TYPES: "╥┼╒" IS THE ╥┼╒ BEING ACCESSED DIRECTLY AND "╥┼╒ THRU ╥╠" IS
  771. THE ╥┼╒ BEING ACCESSED THROUGH A ╥┴═╠INK: THE ╥┼╒ MUST BE PLUGGED INTO THE
  772. ╥┴═ PORT OF THE ╥╠ AND THE ╬ORMAL/─IRECT SWITCH MUST BE IN ╬ORMAL POSITION
  773. AND THE "INDIRECT-REU" PARTITION MUST BE SET UP.  "╥┴═╠INK" IS THE ╥╠
  774. PARTITION "RL-RAM" BEING ACCESSED WITHOUT ╥┼╒ ASSISTANCE AND "╥╠ WITH ╥┼╒"
  775. IS THE ╥╠ PARTITION "RL-RAM" BEING ACCESSED WHEN THE ASSISTANCE OF AN ╥┼╒;
  776. THE ╥┼╒ MUST BE PLUGGED INTO THE ╥┴═ PORT AND THE ╬ORMAL/─IRECT SWITCH CAN
  777. BE IN EITHER POSITION.
  778.  
  779. ╞OR INTERNAL MEMORY, THE 64 HAS ONLY ONE 64╦ INTERNAL BANK, WHEREAS YOUR 128
  780. CAN HAVE EITHER 2, 4, OR 8 (128╦, 256╦, OR 512╦).  ╘HE INTERNAL 128 MEMORY
  781. ABOVE 128╦ IS ACCESSED ACCORDING TO THE ARTICLES IN ╘WIN├ITIES-128
  782. ═AGAZINE.
  783.  
  784. ╫HEN ┴├┼ STARTS, IT DETERMINES THE SIZE OF INTERNAL AND ╥┼╒ MEMORY BY
  785. WRITING SPECIAL VALUES IN THE SAME LOCATIONS OF EACH BANK AND LOOKING FOR
  786. READBACK FAILURES OR WRAP-AROUNDS.  ╚OWEVER, AFTER TESTING A BANK, THE
  787. ORIGINAL CONTENTS OF THE TEST LOCATIONS ARE RESTORED.  ╙O, THE TESTING
  788. PROCESS IS COMPLETELY NON-DESTRUCTIVE.
  789. ------------------------------------------------------------------------------
  790. 5. ─┼╓╔├┼╙
  791.  
  792. 5.1. ├╧══╧─╧╥┼ ├╚┴╥┴├╘┼╥ ─┼╓╔├┼╙
  793.  
  794. ╘HESE ARE REGULAR ├OMMODORE CHARACTER-ORIENTED DEVICES, WHICH REALLY ONLY
  795. INCLUDES THE PRINTER RIGHT NOW.  ╘HE STANDARD ╦ERNAL CALLS ARE MADE FOR
  796. ALL ╔/╧.  ╘HESE DEVICES WILL BEHAVE THE SAME WAY THEY ALWAYS HAVE.
  797.  
  798. 5.2. ─╔╙╦ ─┼╓╔├┼╙
  799.  
  800. 5.2.1. ├╧══╧─╧╥┼ ─╔╙╦ ─┼╓╔├┼╙
  801.  
  802. ╥EGULAR ├OMMODORE DISK UNITS ARE ACCESSED IN THE SAME WAY AS CHARACTER-
  803. ORIENTED ├OMMODORE DEVICES, EXCEPT THAT DISK DEVICES ALSO SUPPORT SPECIAL
  804. OPERATIONS SUCH AS DIRECTORY LISTINGS.  ╘HE STANDARD ╦ERNAL CALLS ARE
  805. USED AND SO ARE THE STANDARD ├OMMODORE-─╧╙ INCANTATIONS FOR OPERATIONS
  806. SUCH AS DELETING (SCRATCHING) A FILE.  ┘OU CAN USE THE "DOS" COMMAND OF
  807. THE COMMAND SHELL TO SEND SPECIAL ├OMMODORE-─╧╙ COMMANDS DIRECTLY TO THESE
  808. DEVICES.
  809.  
  810. 5.2.2. ├═─ ─╔╙╦ ─┼╓╔├┼╙
  811.  
  812. ╞OR ├═─ DISK DEVICES, SUPPORT HAS BEEN ADDED TO THE KERNEL TO REQUEST A
  813. "LONG-FORM" DIRECTORY LISTING, INCLUDING THE DATE AND TIME OF LAST
  814. MODIFICATION OF ALL FILES.  ╘HIS ALLOWS ┴├┼ TO PASS THIS INFORMATION ONTO
  815. APPLICATION PROGRAMS THAT REQUEST A DIRECTORY LISTING FROM THE ├═─ DEVICE.
  816. ╙PECIAL SUPPORT IS ALSO INCLUDED FOR INTERPRETING DIRECTORY AND PATHNAMES.
  817. ╘HE REST OF ACCESSING ├═─ DISK DEVICES IS HANDLED EXACTLY THE SAME AS FOR
  818. REGULAR ├OMMODORE DISK DEVICES.
  819.  
  820. 5.2.2. ╥┴═─╔╙╦ ─┼╓╔├┼
  821.  
  822. ╘HE ╥AMDISK, AS CURRENTLY IMPLEMENTED, HAS ONE MAJOR RESTRICTION: FLAT
  823. FILENAMES.  ╔.E., SUBDIRECTORIES ARE NOT CURRENTLY SUPPORTED.  ╘O MAKE UP
  824. FOR THIS DEFICIENCY, YOU CAN HAVE AS MANY RAMDISKS ACTIVE IN THE SYSTEM AS
  825. YOU LIKE.  ╙ETTING A DEVICE TO BE A RAMDISK IN THE SYSTEM CONFIGURATION IS
  826. VERY EASY: JUST CHANGE THE DEVICE TYPE CODE TO THE RAMDISK TYPE (CODE 4).
  827. ╫HEN THE SYSTEM INITIALIZES, THE KERNEL WILL SCAN THE DEVICE CONFIGURATION
  828. AND INITIALIZE EVERY RAMDISK THAT YOU SPECIFY.  ┼ACH INITIALIZED EMPTY
  829. RAMDISK COSTS 512 BYTES OF FAR MEMORY STORAGE.
  830.  
  831. ┴LL OF THE STANDARD DISK DEVICE OPERATIONS ARE SUPPORTED FOR RAMDISKS,
  832. EXCEPT, OF COURSE FOR "MKDIR" AND "RMDIR", SINCE SUBDIRECTORIES ARE NOT
  833. IMPLEMENTED.  ╘HE OPERATIONS INCLUDE: OPEN FOR READ/WRITE/APPEND, READ,
  834. WRITE, BINARY-LOAD (FOR LOADING PROGRAMS), REMOVE, RENAME, DIRECTORY OPEN &
  835. READ, CHANGE DIRECTORY (TO DEVICE), "DEVINFO", AND "ISDIR" (SEE THE
  836. ┴├┼-128/64 ╨ROGRAMMER'S ╥EFERENCE ╟UIDE FOR FURTHER DESCRIPTIONS OF THESE
  837. OPERATIONS).
  838.  
  839. ╘HE FACTORY-DEFAULT CONFIGURATION FOR RAMDISKS IS TO HAVE TWO OF THEM:
  840. DEVICES "M:" AND "Z:".  ╘HE INTENTION IS THAT YOU WILL USE DEVICE "Z:" FOR
  841. STORING YOUR OFTEN-USED PROGRAMS AND "M:" FOR YOUR GENERAL STORAGE.  ┘OU CAN
  842. STORE EXECUTABLES ON A RAMDISK AND THEY WILL LOAD VERY QUICKLY.  ╞OR THIS
  843. REASON, THE FACTORY-DEFAULT EXECUTABLE SEARCH PATH IS "Z:,A:", MEANING THAT
  844. DEVICE "Z:" WILL BE CHECKED BEFORE DEVICE "A:".
  845.  
  846. ╘O GET GOOD USE OUT OF THE RAMDISKS, IT IS RECOMMENDED THAT IF YOU HAVE A 64
  847. THEN YOU ALSO HAVE AN ╥┼╒ OR SOME OTHER MEMORY EXPANDER.  ╫ITHOUT ANY MEMORY
  848. EXPANSION, IF YOU HAVE DISABLED THE SOFT-80 SCREEN YOU WILL HAVE 16╦ OF FAR
  849. MEMORY FOR STORING RAMDISK DATA AND IF THE SOFT-80 SCREEN IS ENABLED, YOU
  850. WILL ONLY HAVE 6╦.  ╫ITH AN ╥┼╒, YOU CAN USE ALL OF THE ╥┼╒ MEMORY FOR A
  851. RAMDISK IF YOU WISH.  ╧N AN UNEXPANDED 128 YOU WILL HAVE 70╦ OR SO FOR
  852. RAMDISKS.  ╬OTE THAT BECAUSE OF THE "FAR MEMORY" ORGANIZATION OF ┴├┼, THE
  853. FAR MEMORY CAN BE USED TO STORE RAMDISK DATA AND ANY OTHER TYPE OF FAR
  854. MEMORY STORAGE.  ═EMORY UTILIZATION IS DYNAMIC SO YOU DON'T HAVE TO RESERVE
  855. LARGE CHUNKS OF FAR MEMORY EXCLUSIVELY FOR A PARTICULAR PURPOSE.
  856.  
  857. ┴S ADVERTISED AT THE TOP OF THIS DOCUMENT, THE RAMDISK DRIVER IS CAPABLE OF
  858. DELIVERING A PEAK READING SPEED OF ABOUT 1 MEGABYTE PER SECOND.  ╘HIS IS FOR
  859. READING A BIG FILE THAT WAS WRITTEN TO THE RAMDISK IN LARGE CHUNKS, WHERE
  860. THE FILE IS STORED COMPLETELY IN ╥┼╒ MEMORY.  ╞OR A SIMILAR FILE STORED
  861. COMPLETELY IN ╥┴═╠INK MEMORY, THE READING SPEED WILL BE AROUND 56╦/SEC.  ╘HE
  862. WRITING SPEED OF FILES WILL BE APPROXIMATELY THE SAME AS FOR READING FILES,
  863. BECAUSE OF THE WAY THE DATA IS ORGANIZED: THE LIMITING FACTOR IS THE DATA
  864. TRANSFER SPEED RATHER THAN SYSTEM OVERHEAD.  ╘HE ABOVE FIGURES ARE FOR A
  865. ╞AST-MODE ├128.  ┘OU SHOULD GET COMPARABLE ╥┼╒ PERFORMACE FROM ╙LOW-MODE OR
  866. A 64 AND ABOUT HALF THE PERFORMANCE IN ╙LOW MODE FROM A ╥┴═╠INK.
  867.  
  868. ╔ DON'T WANT TO GO INTO TOO MANY DETAILS, BUT TO GET SUCH HIGH PERFORMANCE,
  869. THE RAMDISK DRIVER USES VARIABLE-SIZED DISK BLOCKS.  ┼ACH BLOCK CAN BE
  870. BETWEEN 256 BYTES AND 64╦ IN SIZE AND INCLUDES 6 BYTES OF CONTROL
  871. INFORMATION.  ╫HEN YOU PERFORM A WRITE OPERATION, THE KERNEL WILL WRITE THE
  872. DATA OUT IN THE LARGEST BLOCKS POSSIBLE WITHOUT WASTING SPACE.  ╘HIS WAY,
  873. WHEN THE DATA IS READ BACK IN USING A LARGE "READ" OPERATION, VERY LITTLE
  874. CONTROL OVERHEAD IS NEEDED AND THE DATA CAN BE TRANSFERRED TO INTERNAL
  875. MEMORY IN LARGE CHUNKS, AND THE AGGREGRATED PER-BYTE ACCESSING COST IS
  876. MINIMIZED, ALMOST TO THE RAW HARDWARE-ACCESSING SPEED.
  877.  
  878. ╞UTURE EXPANSION POSSIBILITES FOR THIS DEVICE INCLUDE IMPLEMENTING
  879. SUBDIRECTORIES AND IMPLEMENTING NEW TYPES OF MEMORY WHICH RETAIN THEIR
  880. CONTENTS BETWEEN RUNS OF ┴├┼ (BUT NOT POWER INTERRUPTIONS) SO THAT YOU CAN
  881. HAVE A "PERMANENT" RAMDISK SIMILAR TO THE WAY THAT ╥┴═╠INK PARTITIONS WORK.
  882. ┴S IT IS NOW, ALL RAMDISKS ARE ERASED WHEN THE SYSTEM STARTS, SO YOU HAVE TO
  883. COPY NECESSARY FILES TO THE RAMDISKS EVERY TIME YOU REBOOT.
  884.  
  885. 5.3. ╙├╥┼┼╬
  886.  
  887. 5.3.1. ╬╧╥═┴╠ ╙├╥┼┼╬╙
  888.  
  889. ╘HE SCREEN HAS A CUSTOM DEVICE DRIVER FOR THE 40-COLUMN (╓╔├) SCREEN OF BOTH
  890. THE ├128 AND ├64 AND THE 80-COLUMN (╓─├) SCREEN OF THE ├128.  ╘HE BITMAP-
  891. IMPLEMENTED SOFT-80-COLUMN SCREEN FOR THE 64 IS DESCRIBED IN THE NEXT
  892. SECTION.  ┬ECAUSE OF THE WAY THAT THE SYSTEM HAS BEEN DESIGNED, NEW SCREEN
  893. DRIVERS JUST EASILY SLIP INTO PLACE (WELL, MAYBE IT'S NOT QUITE THAT
  894. EASY...).
  895.  
  896. ╘HE CUSTOM SCREEN DRIVER INCLUDES SUPPORT FOR THE BASIC TEXT-OUTPUT
  897. OPERATION, AS WELL AS SPECIAL FULL-SCREEN ACCESSING CALLS TO ALLOW FOR THE
  898. SIMPLIFIED AND STANDARD IMPLEMENTATION OF FULL-SCREEN PROGRAMS, SUCH AS A
  899. TEXT EDITOR.  ╙UCH A PROGRAM WOULD BE ABLE TO WORK ON THE 40-COLUMN ├64
  900. SCREEN, THE ╙OFT-80 ├64 SCREEN, AS WELL AS THE 80-COLUMN ├128 SCREEN, WITH
  901. NO MODIFICATION.  ╘HE ├OMMODORE ╦ERNAL INCLUDES VERY LITTLE SUPPORT FOR
  902. FULL-SCREEN APPLICATIONS (ONLY NUMEROUS CONTROL CHARACTER CODES).
  903.  
  904. ╞OR THE REGULAR OUTPUT, ONLY THE SCREEN CHARACTERS AND NOT THE COLORS ARE
  905. USED (NORMALLY), WHICH ALLOWS SCROLLING TO BE TWICE AS FAST.  ╧UTPUTING
  906. CHARACTERS IS ALSO FASTER BECAUSE FEWER CONTROL CHARACTERS ARE SUPPORTED, NO
  907. TRANSLATIONS BETWEEN ╨┼╘╙├╔╔ AND SCREEN CODES NEEDS TO TAKE PLACE, AND
  908. OPERATIONS ARE OPTIMIZED FOR SPEED (RATHER THAN ╥╧═ SIZE).  ╘HE DISPLAY
  909. CHARACTER SET HAS BEEN REARRANGED TO CORRESPOND TO THE ╨┼╘╙├╔╔ CHARACTER
  910. CODES, EXCEPT FOR THE "├OMMODORE" CHARACTERS.  ╘HE GRAPHICS CHARACTERS HAVE
  911. BEEN RE-THOUGHT FOR APPLICATIONS.  ╘HE SCREEN DRIVER ALSO INCLUDES BASIC
  912. SUPPORT FOR USER-WINDOWS, WHICH WILL BE TAKEN ADVANTAGE OF IN FUTURE
  913. APPLICATIONS.
  914.  
  915. ┴ PRESCROLLING FEATURE HAS BEEN IMPLEMENTED TO CUT DOWN ON THE NUMBER OF
  916. TIMES THE SCREEN HAS TO BE SCROLLED IN DISPLAYING TEXT, TO INCREASE THE
  917. DISPLAY SPEED.
  918.  
  919. 5.3.2. ┬╔╘═┴╨╨┼─ 80-├╧╠╒═╬ ╙├╥┼┼╬ ╞╧╥ ╘╚┼ 64
  920.  
  921. ╘HIS SCREEN IS IMPLEMENTED WITH A ╓╔├ BITMAP AND 4X8-PIXEL CHARACTERS.  ╘HE
  922. SCREEN MAPS INTO MEMORY UNDER THE ├OMMODORE ╦ERNAL ╥╧═.  ╘HE ATTRIBUTE BITS
  923. OF COLOR VALUES ACT AS BACKGROUND COLOR FOR COLOR CELLS, AND THE COLOR CELLS
  924. COVER TWO CHARACTER SPACES, BECAUSE OF THE ╓╔├ HARDWARE.
  925.  
  926. ┼R, ╔ SHOULD MENTION ABOUT THE CHARACTER SET.  ╘HE ONE ╔ HAVE ╔ CAME UP WITH
  927. FOR A ╓╔├-20 40-COL SCREEN PROGRAM A LONG TIME AGO BUT IT MAY NOT BE IDEAL
  928. FOR THE SMALLER PIXELS OF THE 64.  ╔ HAVE SELECTED THE DEFAULT SCREEN COLORS
  929. (BLACK ON GRAY) TO DISPLAY THE CHARACTERS CLEARLY.  ╔T WORKS BEST IF YOU
  930. TURN THE BRIGHTNESS UP ON YOUR MONITOR, TO CUT DOWN ON THE PIXEL DISTORTION
  931. OF THE 64 DISPLAY.  ╔F YOU COME UP WITH A BETTER CHARACTER SET OR SCREEN
  932. COLOR COMBINATION, PLEASE LET ME KNOW.  ╘HE FORMAT OF THE CHARACTER SET IS
  933. EXPLAINED IN THE "ACE╬╬-TECH.DOC" DOCUMENT.
  934.  
  935. 5.3.3. ╟╥┴╨╚╔├╙ ╙├╥┼┼╬╙
  936.  
  937. ╘HE KERNEL HAS BEEN EXTENDED TO INCLUDE BASIC SUPPORT FOR 320*200 MONOCHROME
  938. GRAPHICS ON THE 64 AND 640*200 AND 640*491 (64╦ ONLY) USING THE ╓─├ DISPLAY
  939. OF THE 128.  ╘HE 320*200 AND 640*491 DISPLAYS HAVE A PIXEL ASPECT OF 1-TO-1
  940. AND THE 640*200 DISPLAY HAS A PIXEL ASPECT RATIO OF 2-TO-1.  ╘HE ASPECT
  941. RATIO IS MADE AVAILABLE TO APPLICATION PROGRAMS SO THEY CAN CORRECT IT, IF
  942. THEY SO CHOOSE.  ╘HE BASIC SUPPORT THE KERNEL PROVIDES INCLUDES ONLY GETTING
  943. IN AND OUT OF GRAPHICS MODE, FILLING THE SCREEN WITH A GIVEN BYTE VALUE, AND
  944. LOADING THE BYTES OF A DISPLAY LINE.  ┴ NUMBER OF EXTENSIONS ARE POSSIBLE,
  945. BUT ╔'D LIKE TO KEEP IT SIMPLE TO KEEP DOWN THE KERNEL SIZE.
  946.  
  947. 5.4. ╦┼┘┬╧┴╥─
  948.  
  949. ┴ CUSTOM KEYBOARD SCANNER HAS BEEN ADDED ALSO.  ╔T SUPPORTS A THREE-KEY
  950. ROLLOVER AS DISCUSSED IN ├= ╚ACKING ╬ET ═AGAZINE ╔SSUE #6.  ╘HE KEY
  951. MATRICIES WILL BE EXTENDED TO INCLUDE A NUMBER OF STANDARD CONTROL CHARACTERS
  952. FOR THINGS LIKE "PAGE UP," ETC.  ╦EY SCANNING HAS BEEN COMPLETELY TAKEN OVER
  953. TO IMPLEMENT THE THREE-KEY ROLLOVER, AND TO AVOID INTERFERENCE WITH THE
  954. JOYSTICK IN PORT #1.
  955.  
  956. ╘HERE ARE A FEW NEW KEYBOARD CONTROLS.  ╘O TEMPORARILY PAUSE A LISTING GOING
  957. TO THE SCREEN, PRESS THE ├╧╬╘╥╧╠ KEY.  ╧UTPUT WILL RESUME WHEN YOU RELEASE
  958. THE KEY.  ╞OR THE ├128, THE ╬╧ ╙├╥╧╠╠ KEY IS SUPPORTED IN THE NORMAL WAY.
  959. ╧N THE 64, TO ACHIEVE THE SAME EFFECT, PRESS THE ╥╒╬/╙╘╧╨ KEY WHILE HOLDING
  960. DOWN THE ├╧╬╘╥╧╠ KEY TO PAUSE OUTPUT UNTIL YOU EXPLICITLY RE-ENABLE IT.  ╘O
  961. DO THIS, JUST PRESS ╬╧ ╙├╥╧╠╠ (128) OR ├╧╬╘╥╧╠-╙╘╧╨ (64) AGAIN.  ╧N THE 128,
  962. THE ├┴╨╙ KEY IS SUPPORTED IN THE NORMAL WAY (WITH ├┴╨╙-╤ FIXED), AND TO
  963. ACTIVATE CAPS LOCK MODE ON THE 64, PRESS ├╧══╧─╧╥┼-╙╘╧╨, AND PRESS IT AGAIN
  964. TO RELEASE CAPS LOCK MODE.  ╘HE KEY DELAY AND REPEAT RATES ARE NOT USER-
  965. DEFINABLE RIGHT NOW, BUT THEY WILL BE.  ┴LSO, FUNCTION KEYS WILL BE
  966. APPLICATION-DEFINABLE (WHERE THE COMMAND SHELL CAN BE CONSIDERED AN
  967. APPLICATION).  ╙OMETHING THAT YOU MAY FIND ODD IS THAT THE CURSOR COLOR CAN
  968. BE DIFFERENT FROM THE CHARACTER COLOR.  ─EAL WITH IT.
  969.  
  970. ╞ULL INPUT LINE EDITING IS SUPPORTED.  ╠INES MAY BE UP TO 248 CHARACTERS
  971. LONG, INCLUDING THE CARRIAGE RETURN.  ┘OU CAN DELETE THE CHARACTER BEFORE
  972. THE CURSOR BY TYPING ─┼╠.  ┘OU CAN USE THE CURSOR ╠┼╞╘ AND ╥╔╟╚╘ KEYS TO
  973. MOVE THE CURSOR ON THE CURRENT INPUT LINE AND ANY CHARACTERS YOU TYPE WILL
  974. BE INSERTED BEFORE THE CHARACTER THAT THE CURSOR IS ON.  ├╧-╠┼╞╘ AND
  975. ├╧-╥╔╟╚╘ (ON THE 128 WITH THE UPPER CURSOR KEYS) MOVE THE CURSOR TO THE
  976. BEGINNING AND END OF THE CURRENT LINE.  ├╘-╩ AND ├╘-╦ DO THE SAME THING.
  977. ╫HEN YOU WISH TO GENERATE AN ┼╧╞ (END-OF-FILE) SIGNAL FROM THE KEYBOARD,
  978. PRESS ├╧╬╘╥╧╠-─.  ╘HIS WILL ONLY WORK ON AN EMPTY LINE; OTHERWISE, YOU WILL
  979. GET THE ├╘-─ CHARACTER.
  980.  
  981. ╔F YOU WISH TO EDIT AND RE-ENTER A PREVIOUS LINE, PRESS THE CURSOR-╒╨ KEY
  982. WHEN THE SYSTEM PROMPTS YOU FOR AN INPUT LINE.  ╘HIS WILL RECALL THE
  983. PREVIOUS LINE.  ┘OU CAN PRESS CURSOR-╒╨ AND ─╧╫╬ TO SCAN THROUGH ALL OF THE
  984. SCROLL BUFFER LINES YOU HAVE ALLOCATED IN THE CONFIGURATION.  ┬UFFERING EACH
  985. LINE WILL COST YOU 256 BYTES OF FAR MEMORY.
  986.  
  987. ╫HEN YOU HAVE SELECTED A PREVIOUS INPUT LINE, YOU CAN EDIT IT OR RE-ENTER IT
  988. JUST LIKE NORMAL.  ╘HE INSTANT THAT YOU CHANGE OR ENTER THE LINE, IT BECOMES
  989. THE CURRENT LINE.  ╧THERWISE, IF YOU DON'T CHANGE A PREVIOUS LINE, THEN YOU
  990. CAN SCROLL BACK DOWN TO THE CURRENT LINE YOU WERE WORKING ON BEFORE.  ╘HIS
  991. IS USEFUL FOR CHECKING SOME ITEM ON A PREVIOUS LINE AND THEN CONTINUING WITH
  992. THE CURRENT LINE.  ╫HEN YOU SCROLL BACK TO THE END OF THE HISTORY BUFFER,
  993. THE BELL WILL RING IF YOU TRY TO SCROLL BACK ANY FARTHER.  ┬LANK LINES ARE
  994. NOT ENTERED IN THE SCROLLBACK BUFFER.  ┴LSO, ALL LINES RATHER THAN JUST THE
  995. COMMAND LINES ARE SAVED (ALTHOUGH ╔ MAY RECONSIDER THIS LATER).
  996.  
  997. ═ANY APPLICATIONS WILL MAKE USE OF A NUMBER OF KEY COMBINATIONS, SO HERE IS
  998. A RECOMMENDED SET OF CONTROL CODES AND HOW THEY SHOULD NORMALLY BE
  999. INTERPRETED BY APPLICATION PROGRAMS.  ╬OTE THAT THE KEYS FOR "@" TO "_",
  1000. USED IN ASSOCIATION WITH SHIFTING KEYS, ARE
  1001. "@┴┬├─┼╞╟╚╔╩╦╠═╬╧╨╤╥╙╘╒╓╫╪┘┌[\]^_".  "├╘" MEANS ├ONTROL, "╙╚" MEANS ╙HIFT,
  1002. "┴╠" MEANS ┴LTERNATE, AND "├╧" MEANS ├OMMODORE.  ╧N THE ├64, ┴LTERNATE IS
  1003. OBTAINED BY HOLDING DOWN THE ├OMMODORE AND ├ONTROL KEYS SIMULTANEOUSLY, AND
  1004. "├╙" BELOW MEANS TO HOLD DOWN THE ├OMMODORE AND ╙HIFT KEYS SIMULTANEOUSLY.
  1005. ╘HE "├╙" COMBINATION IS USED TO MAKE THE FUNCTIONS OF KEYS ONLY PROVIDED ON
  1006. THE ├128'S EXTENDED KEYBOARD AVAILABLE ON THE ├64.
  1007.  
  1008. ├╧─┼(S)   ├128 ╦┼┘(S)    ├64 ╦┼┘(S)     ─┼╙├╥╔╨╘╔╧╬
  1009. -------   ------------   ------------   -----------
  1010. $5C       ┬RITISH╨OUND   ┬RITISH╨OUND   (\) THE BACKSLASH CHARACTER
  1011. $5E       ╒P┴RROW        ╒P┴RROW        (^) THE CARRET CHARACTER
  1012. $5F       ┬ACK┴RROW      ┬ACK┴RROW      (_) THE UNDERSCORE CHARACTER
  1013. $C0       ╙╚-*           ╙╚-*           (└) THE BACK-QUOTE CHARACTER
  1014. $DB       ╙╚-+           ╙╚-+           (█) THE LEFT-CURLY-BRACE CHARACTER
  1015. $DC       ╙╚-┬RIT╨OUND   ╙╚-┬RIT╨OUND   (▄) THE VERTICAL-BAR CHARACTER
  1016. $DE       ╙╚-- (MINUS)   ╙╚-- (MINUS)   (▌) THE RIGHT-CURLY-BRACE CHARACTER
  1017. $DF       ╙╚-┬ACK┴RROW   ╙╚-┬ACK┴RROW   THE HOUSE CHARACTER (─┼╠ IN ┴╙├╔╔)
  1018.  
  1019. ├╧─┼(S)   ├128 ╦┼┘(S)    ├64 ╦┼┘(S)     ─┼╙├╥╔╨╘╔╧╬
  1020. -------   ------------   ------------   -----------
  1021. $20-$3F   ╙╨┴├┼ TO "?"   ╙╨┴├┼ TO "?"   ╥EGULAR NUMBERS AND PUNCTUATION
  1022. $40-$5F   "@" TO "_"     "@" TO "_"     ╥EGULAR LOWERCASE LETTERS
  1023. $60-$7F   ┴╠-@ TO ┴╠-_   <UNDECIDED>    ┴LTERNATE KEYS
  1024. $A0-$BF   ├╧-@ TO ├╧-_   ├╧-@ TO ├╧-_   ├OMMODORE KEYS
  1025. $C0-$DF   "└" TO ╚╧╒╙┼   "└" TO ╚╧╒╙┼   ╥EGULAR UPPERCASE LETTERS
  1026. $E0-$EF   ├╘-@ TO ├╘-_   ├╘-@ TO ├╘-_   ├ONTROL KEYS
  1027.  
  1028. ├╧─┼(S)   ├128 ╦┼┘(S)    ├64 ╦┼┘(S)     ─┼╙├╥╔╨╘╔╧╬
  1029. -------   ------------   ------------   -----------
  1030. $00       <NONE>         <NONE>         <CANNOT BE GENERATED-╔ MAY CHANGE THIS>
  1031. $01       ├╘-╥┼╘╒╥╬      ├╘-╥┼╘╒╥╬      ┼ND OF FILE
  1032. $02       ╙╚-╘┴┬         ├╙-╥           ┬ACKTAB
  1033. $03       ╙╘╧╨           ╙╘╧╨           ╙TOP SOME OPERATIONS
  1034. $04       ╚┼╠╨           ├╙-╚           ├ONTEXT-SENSITIVE HELP
  1035. $05       ├╘-2           ├╘-2           ╫HITE
  1036. $06       ╙╚-╠┼╞╘        ├╙-┬           ╫ORD LEFT
  1037. $07       ╙╚-╠╔╬┼╞┼┼─    ├╙-╨           ═ENU EXIT
  1038. $08       ├╧-─┼╠         ├╧-─┼╠         ╥UBOUT CHARACTER UNDER CURSOR
  1039. $09       ╘┴┬            ├╙-╘           ╘AB
  1040. $0A       ╠╔╬┼╞┼┼─       ├╙-╠           ═ENU
  1041. $0B       ╙╚-╥╔╟╚╘       ├╙-╬           ╫ORD RIGHT
  1042. $0C       ├╧-╒╨          ├╙-╫           ╟OTO TOP OF DOCUMENT
  1043. $0D       ╥┼╘╒╥╬         ╥┼╘╒╥╬         ╥ETURN
  1044. $0E       ╙╚-┼╙├┴╨┼      ├╙-─           ╫INDOW CONTROL
  1045. $0F       ├╧-─╧╫╬        ├╙-┌           ╟OTO BOTTOM OF DOCUMENT
  1046. $10       ├╧-╠┼╞╘        ├╙-┴           ╟OTO BEGINNING OF LINE
  1047. $11       ─╧╫╬           ─╧╫╬           ├URSOR DOWN
  1048. $12       ├╘-9           ├╘-9           ╥VS
  1049. $13       ╚╧═┼           ╚╧═┼           ╚OME
  1050. $14       ─┼╠            ─┼╠            ┬ACKSPACE
  1051. $15       ├╧-╥╔╟╚╘       ├╙-╙           ╟OTO END OF LINE
  1052. $16       ├╘-╒╨          ├╙-╔           ╨AGE UP
  1053. $17       ├╘-─╧╫╬        ├╙-═           ╨AGE DOWN
  1054. $18       ├╘-╘┴┬         ├╙-┘           ╘AB SET
  1055. $19       ├╘-╠┼╞╘        ├╙-╩           ╨AGE LEFT
  1056. $1A       ├╘-╥╔╟╚╘       ├╙-╦           ╨AGE RIGHT
  1057. $1B       ┼╙├┴╨┼         ├╙-┼           ┼SCAPE
  1058. $1C       ├╘-3           ├╘-3           ╥ED
  1059. $1D       ╥╔╟╚╘          ╥╔╟╚╘          ├URSOR RIGHT
  1060. $1E       ├╘-6           ├╘-6           ╟REEN
  1061. $1F       ├╘-7           ├╘-7           ┬LUE
  1062.  
  1063. ├╧─┼(S)   ├128 ╦┼┘(S)    ├64 ╦┼┘(S)     ─┼╙├╥╔╨╘╔╧╬
  1064. -------   ------------   ------------   -----------
  1065. $80       ├╘-╞1          ├╘-╞1          ╞UNCTION KEY 9
  1066. $81       ├╧-1           ├╧-1           ╧RANGE/╨URPLE(?)
  1067. $82       ├╘-╞3          ├╘-╞3          ╞UNCTION KEY 10
  1068. $83       ╙╚-╙╘╧╨        ╙╚-╙╘╧╨        ╥UN
  1069. $84       ╙╚-╚┼╠╨        ├╙-╟           ├ONTEXT-INSENSITIVE HELP
  1070. $85       ╞1             ╞1             ╞UNCTION KEY 1
  1071. $86       ╞3             ╞3             ╞UNCTION KEY 3
  1072. $87       ╞5             ╞5             ╞UNCTION KEY 5
  1073. $88       ╞7             ╞7             ╞UNCTION KEY 7
  1074. $89       ╙╚-╞1          ╙╚-╞1          ╞UNCTION KEY 2
  1075. $8A       ╙╚-╞3          ╙╚-╞3          ╞UNCTION KEY 4
  1076. $8B       ╙╚-╞5          ╙╚-╞5          ╞UNCTION KEY 6
  1077. $8C       ╙╚-╞7          ╙╚-╞7          ╞UNCTION KEY 8
  1078. $8D       ╙╚-╥┼╘╒╥╬      ╙╚-╥┼╘╒╥╬      <UNDECIDED>
  1079. $8E       ├╘-╞5          ├╘-╞5          ╞UNCTION KEY 11
  1080. $8F       ├╘-╞7          ├╘-╞7          ╞UNCTION KEY 12
  1081. $90       ├╘-1           ├╘-1           ┬LACK
  1082. $91       ╒╨             ╒╨             ├URSOR UP
  1083. $92       ├╘-0           ├╘-0           ╥VS OFF
  1084. $93       ╙╚-╚╧═┼        ╙╚-╚╧═┼        ├LEAR SCREEN
  1085. $94       ╙╚-─┼╠┼╘┼      ╙╚-─┼╠┼╘┼      ╔NSERT ONE SPACE
  1086. $95       ├╧-2           ├╧-2           ┬ROWN
  1087. $96       ├╧-3           ├╧-3           ╠IGHT RED
  1088. $97       ├╧-4           ├╧-4           ─ARK GRAY
  1089. $98       ├╧-5           ├╧-5           ═EDIUM GRAY/DARK CYAN(?)
  1090. $99       ├╧-6           ├╧-6           ╠IGHT GREEN
  1091. $9A       ├╧-7           ├╧-7           ╠IGHT BLUE
  1092. $9B       ├╧-8           ├╧-8           ╠IGHT GRAY
  1093. $9C       ├╘-5           ├╘-5           ═AGENTA
  1094. $9D       ╠┼╞╘           ╠┼╞╘           ├URSOR LEFT
  1095. $9E       ├╘-8           ├╘-8           ┘ELLOW
  1096. $9F       ├╘-4           ├╘-4           ├YAN
  1097.  
  1098. ╞OR THE ─VORAK KEY MATRIX, THE FOLLOWING COMBINATION OF ─VORAK AND ├OMMODORE
  1099. IS USED ON THE BASIC KEYBOARD:
  1100.  
  1101.     +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
  1102.     ▄ _ ▄ 1 ▄ 2 ▄ 3 ▄ 4 ▄ 5 ▄ 6 ▄ 7 ▄ 8 ▄ 9 ▄ 0 ▄ + ▄ - ▄ \ ▄HOM▄DEL▄
  1103.     +---------------------------------------------------------------+
  1104.     ▄CTRL ▄ @ ▄ , ▄ . ▄ ╨ ▄ ┘ ▄ ╞ ▄ ╟ ▄ ├ ▄ ╥ ▄ ╠ ▄ / ▄ * ▄ ^ ▄RESTR▄
  1105.     +---------------------------------------------------------------+
  1106.     ▄STP▄SHL▄ ┴ ▄ ╧ ▄ ┼ ▄ ╒ ▄ ╔ ▄ ─ ▄ ╚ ▄ ╘ ▄ ╬ ▄ ╙ ▄ ; ▄ = ▄ RETURN▄
  1107.     +---------------------------------------------------------------+
  1108.     ▄ ├=▄SHIFT▄ : ▄ ╤ ▄ ╩ ▄ ╦ ▄ ╪ ▄ ┬ ▄ ═ ▄ ╫ ▄ ╓ ▄ ┌ ▄SHIFT▄ V ▄-> ▄
  1109.     +---+-----+---+---+---+---+---+---+---+---+---+---+-----+---+---+
  1110.  
  1111. ┴LL OF THE KEYS ARE MOVED AS A UNIT, SO SHIFTING A KEY WILL PRODUCE THE SAME
  1112. RESULT AS THE CORRESPONDING KEY IN THE STANDARD ├OMMODORE ╤WERTY LAYOUT.
  1113. ╘HE EXTENDED KEYS REMAIN THE SAME.  ╔F YOU WANT TO REDEFINE THE KEY MATRIX
  1114. YOURSELF, THEN LOOK IN THE "ACEKEY-DVORAK.S" FOR MORE INFORMATION.  ╔T IS AN
  1115. ┴├┼-ASSEMBLER SOURCE FILE THAT ENCODES THE TRANSLATION TABLES.
  1116.  
  1117. 5.5 ╒╙┼╥-╨╧╥╘ ╔╬╘┼╥-═┴├╚╔╬┼ ╬┼╘╫╧╥╦ ─┼╓╔├┼
  1118.  
  1119. ╘HE DEVICE FOLLOWS FROM WHAT WAS OUTLINED IN ISSUE #8 OF ├= ╚ACKING NET
  1120. MAGAZINE.  ╔T ALLOWS YOU TO SEND BYTES OF DATA FROM ONE COMPUTER TO ANOTHER,
  1121. WHICH IS ALL THAT ANY NETWORK, NO MATTER HOW COMPLICATED, ACTUALLY DOES.
  1122. ╫ITH THIS ABILITY, YOU CAN WRITE ARBITRARILY COMPLEX DISTRIBUTED
  1123. APPLICATIONS.  ╫ELL, BEFORE WE GET TOO GRAND, THE "NETWORK" IS CURRENTLY
  1124. LIMITED TO ONLY CONNECTING TWO COMPTERS TOGETHER.  ╚ERE IS HOW THE WIRING
  1125. GOES IF YOU WANT TO MAKE YOUR OWN NETWORK CABLE:
  1126.  
  1127. ╚OST-┴  NAME/PIN                                      PIN/NAME  ╚OST-┬
  1128.          ╟╬─ <┴>+------------------------------------+<┴> ╟╬─
  1129.         ╞╠┴╟ <┬>+------------------------------------+<8> ╨├2 ***
  1130.          ╨┬0 <├>+------------------------------------+<├> ╨┬0
  1131.          ╨┬1 <─>+------------------------------------+<─> ╨┬1
  1132.          ╨┬2 <┼>+------------------------------------+<┼> ╨┬2
  1133.          ╨┬3 <╞>+------------------------------------+<╞> ╨┬3
  1134.          ╨┬4 <╚>+------------------------------------+<╚> ╨┬4
  1135.          ╨┬5 <╩>+------------------------------------+<╩> ╨┬5
  1136.          ╨┬6 <╦>+------------------------------------+<╦> ╨┬6
  1137.          ╨┬7 <╠>+------------------------------------+<╠> ╨┬7
  1138.          ╨┴2 <═>+------------------------------------+<═> ╨┴2 (OR USE AS ╨├2)
  1139.          ╟╬─ <╬>+------------------------------------+<╬> ╟╬─
  1140.         ├╬╘2 <6>+------------------------------------+<6> ├╬╘2
  1141.          ╙╨2 <7>+------------------------------------+<7> ╙╨2
  1142.          ╨├2 <8>+------------------------------------+<┬> ╞╠┴╟ ***
  1143.  
  1144. ╚ERE IS THE ├OMMODORE 128/64 ╒SER ╨ORT WHEN LOOKING AT THE BACK OF THE UNIT:
  1145.  
  1146.                              111
  1147.      (OTHER)        123456789012    TOP          (EDGE OF)
  1148.      (PORTS)        ------------                 (MACHINE)
  1149.                     ┴┬├─┼╞╚╩╦╠═╬    BOTTOM
  1150.  
  1151. ┘OU WILL NEED TWO APPROPRIATE CONNECTORS AND SOME 14-CONDUCTOR RIBBON CABLE
  1152. TO BUILD THE NETWORK.  ╧NE OF MY CONNECTORS IS A 44-CONDUCTOR CONNECTOR OF
  1153. THE TYPE USED WITH THE ╓╔├-20 EXPANSION PORT THAT ╔ SAWED IN HALF AND THE
  1154. CABLE IS SOME OLD JUNK RIBBON CABLE THAT WAS LYING AROUND THAT ╔ REMOVED
  1155. SOME OF THE CONDUCTORS FROM.  ┴NY OLD JUNK WILL DO.  ┘OU'RE PROBABLY BEST
  1156. OFF IF YOUR CABLE IS LESS THAN TWO METRES LONG (SIX FEET).
  1157.  
  1158. ╘HERE ARE TWO SOFTWARE PROTOCOLS IMPLEMENTED FOR TRANSMITTING BYTES OVER THE
  1159. NETWORK: ╥AW AND ╨ACKET.  ╘HE ╥AW PROTOCOL JUST SENDS THE RAW BYTES USING
  1160. ONLY THE HARDWARE HANDSHAKING.  ╘HIS SHOULD BE SUITABLE FOR USE WITH
  1161. PARALLEL- PORT PRINTERS.  ╘HE ╨ACKET PROTOCOL WRITES THREE BYTES OF HEADER
  1162. INFORMATION PLUS THE GIVEN DATA FOR EACH "WRITE" OPERATION TO THE DEVICE.
  1163. ╘HE HEADER INFORMATION CONSISTS OF THE VALUE $┼6, FOLLOWED BY THE LOW BYTE
  1164. OF THE NUMBER OF DATA BYTES TO FOLLOW, FOLLOWED BY THE HIGH BYTE OF THE
  1165. COUNT, FOLLOWED BY THE DATA BYTES THEMSELVES.  ╘HIS PROTOCOL ALLOWS THE
  1166. OTHER END TO KNOW WHAT THE PACKET BOUNDARIES ARE, AND PACKET BOUNDARIES ARE
  1167. NEEDED FOR INTERACTIVE INTERPROCESS COMMUNICATION, SUCH AS WITH ╥╨├S (╥EMOTE
  1168. ╨ROCEDURE ├ALLS).   ╘HE IMPLEMENTED PROTOCOL ALSO SENDS A PACKET WITH ZERO
  1169. USER-DATA BYTES OUT WHEN YOU USE THE "CLOSE" SYSTEM CALL ON THE USER-PORT
  1170. DEVICE, SO THE ╨ACKET PROTOCOL IS ALSO USEFUL FOR TRANSFERRING FILES FROM
  1171. ONE MACHINE TO ANOTHER┴.
  1172.  
  1173. ┬UT, SINCE THE NETWORK IS INHERENTLY HALF-DUPLEX (DATA CAN ONLY FLOW IN ONE
  1174. DIRECTION AT A TIME), YOU MUST BE VERY CAREFUL ABOUT COORDINATING THINGS SO
  1175. THAT YOU ALWAYS HAVE ONE TRANSMITTER AND ONE RECEIVER WHENEVER YOU ARE
  1176. TRANSFERRING DATA.  ╔F BOTH HOSTS TRY TO RECEIVE OR BOTH TRY TO TRANSMIT AT
  1177. THE SAME TIME, THEY WILL BOTH DEADLOCK FOREVER (OR UNTIL YOU RESET THEM).
  1178.  
  1179. ┴S AN EXAMPLE, IF YOU WANTED TO TRANSFER A FILE OVER THE NETWORK, YOU
  1180. WOULD ENTER THE FOLLOWING ON THE RECEIVING COMPUTER:
  1181.  
  1182. CAT U: >FILE
  1183.  
  1184. AND THE FOLLOWING ON THE TRANSMITTING COMPUTER:
  1185.  
  1186. CAT FILE >U:
  1187.  
  1188. ╘HE DEVICE OPERATES MUCH LIKE A ╒NIX "PIPE".  ┘OU CAN ALSO USE THE "CP" OR
  1189. "BCODE" OR WHATEVER AND YOU THE ORDER IN WHICH YOU START THE TRANSMITTER/
  1190. RECEIVER DOESN'T MATTER.  ╘HE PACKET SIZE ON THE NETWORK IS VARIABLE AND IS
  1191. DEFINED BY THE SIZE OF WRITE CALL THAT THE TRANSMITTER PERFORMS A WRITE
  1192. OPERATION.
  1193.  
  1194. ╞LOW-CONTROL HANDSHAKING IS PERFORMED FOR EACH BYTE SENT, SO THE WRITER WILL
  1195. BE DELAYED IN THE WRITE SYSTEM CALL UNTIL THE RECEIVER HAS RECEIVED EVERY
  1196. LAST BYTE OF THE PACKET BY PERFORMING APPROPRIATE READ OPERATIONS.  ╘HIS
  1197. MEANS THAT THE WRITER WILL OPERATE SYNCHRONOUSLY WITH THE READER IF THE
  1198. RECEIVE BUFFER (READ SIZE) IS SMALLER THAN THE TRANSMIT BUFFER (WRITE SIZE)
  1199. AND THAT THE WRITER WILL OPERATE ASYNCHRONOUSLY (*CONCURRENTLY*) WITH THE
  1200. RECEIVER IF THE RECEIVE BUFFER IS LARGER THAN OR EQUAL IN SIZE TO THE
  1201. TRANSMIT BUFFER.  ├ONCURRENCY IS GOOD.  ┴LSO, READS WILL SOMETIMES RETURN
  1202. "SHORT BLOCKS", BLOCKS WITH FEWER BYTES THAN THE READ REQUEST SPECIFIED.
  1203. ╘HIS IS TO ALLOW THE DEVICE TO BE TRULY PACKET-ORIENTED, WHICH CAN ALLOW
  1204. CLIENT/SERVER-TYPE INTERACTIONS OVER THE HALF-DUPLEX COMMUNICATION LINE.
  1205.  
  1206. ╘HE MAXIMUM TRANSFER RATE IS CURRENTLY AROUND 40╦/SEC.  ╘HE MAXIMUM RATE
  1207. POSSIBLE, IF SOFTWARE WERE AS EFFICIENT AS POSSIBLE, WOULD BE ABOUT 80╦/SEC
  1208. WITH TWO ╞AST-MODE ├128S.
  1209.  
  1210. 5.6. ╙╫╔╞╘╠╔╬╦-232 ─┼╓╔├┼
  1211.  
  1212. ╘HIS DEVICE DRIVER SUPPORTS ├REATIVE ═ICRO ─ESIGN'S ╙WIFT╠INK-232 CARTRIDGE,
  1213. WHICH IS BASED ON THE 6551 ┴├╔┴ CHIP.  ╘HE WAY TO CONFIGURE THE OPERATION OF
  1214. THIS DEVICE (RECEIVE-BUFFER SIZE, BAUD RATE, WORD-LENGTH/PARITY/STOP-BITS)
  1215. WAS DISCUSSED IN THE ╙YSTEM ├ONFIGURATION SECTION.  ├URRENTLY, THE DEVICE
  1216. WILL WORK ONLY FROM ╔/╧ SLOT $─┼00, AND ╔ DON'T REALLY HAVE ANY PLANS TO
  1217. CHANGE THIS, SINCE IT WOULD BE A PAIN TO DO, UNLESS THERE IS OVERWHELMING
  1218. DEMAND.
  1219.  
  1220. ╚ERE ARE A COUPLE OF NOTES ABOUT THE DEVICE DRIVER.  ╔T WILL OPERATE
  1221. FLAWLESSLY AT 38,400 BAUD ON BOTH THE ├128 AND ├64.  ┴T THIS SPEED, THE
  1222. MACHINE WILL HAVE TO PROCESS 3840 INTERRUPTS PER SECOND, WHICH MEANS THAT IT
  1223. HAS ONLY 266 SLOW TICKS (╬╘╙├) PER CHARACTER RECEIVED.  ╘HE DEVICE DRIVER
  1224. ALSO IMPLEMENTS HARDWARE FLOW CONTROL OUT OF PRACTICAL NECESSITY.  ╔F YOU
  1225. ARE OPERATING AT 38,400 BAUD, THEN IT IS LIKELY THAT (A) WHATEVER YOU'RE
  1226. CONNECTED TO SUPPORTS HARDWARE FLOW CONTROL (╚╞├), AND (B) THAT YOUR
  1227. APPLICATION WON'T BE ABLE TO KEEP UP ALL OF THE TIME.  ╘HE ╚╞├ WORKS
  1228. FLAWLESSLY AS FAR AS ╔ HAVE TESTED.  ┬ECAUSE OF THE IMMEDIACY OF ╚╞├, THE
  1229. DEVICE WILL ASSERT ╚╞├ WHEN THERE ARE FEWER THAN 8 BYTES FREE IN THE RECEIVE
  1230. BUFFER (A SMALL LIMIT) AND WILL RELEASE IT WHERE THERE ARE 16 OR MORE BYTES
  1231. FREE IN THE RECEIVE BUFFER.
  1232.  
  1233. ┴N UNFORTUNATE HARDWARE RESTRICTION OF THE 6551 ┴├╔┴ IS THAT IT CANNOT
  1234. TRANSMIT DATA WHILE THE ╚╞├ IS ASSERTED.  ╘HIS MAKES CONTROLLING TRANSMIT
  1235. DATA MORE COMPLICATED BUT ALSO MAKES IT SO THAT THE ╥╘╙/├╘╙ SIGNALS
  1236. SIMULTANEOUSLY WORK ACCORDING TO THEIR STANDARD DEFINITIONS AND ALSO TO
  1237. THEIR NEWER FLOW-CONTROL DEFINITIONS.  ╘HIS IS OKAY, SINCE NEWER HIGH-SPEED
  1238. MODEMS USUALLY INTERPRET THESE SIGNALS IN THE FLOW-CONTROL WAY AND OLDER
  1239. MODEMS ARE LIKELY TO OPERATE AT A BAUD RATE WHERE FLOW CONTROL IS NOT
  1240. NEEDED.  ╬OTE THAT IF FLOW CONTROL IS IGNORED BY YOUR MODEM AND THE RECEIVE
  1241. BUFFER OVERFLOWS, THEN YOU ╫╔╠╠ LOSE CHARACTERS.  ╘HE ╙╠ DRIVER COLLECTS
  1242. STATISTICS ABOUT THIS (NUMBER OF HARDWARE OVERRUNS, NUMBER OF
  1243. SOFTWARE-BUFFER OVERFLOWS, NUMBER OF BYTES SENT, NUMBER OF BYTES RECEIVED).
  1244.  
  1245. ╘HE ╙WIFT╠INK DRIVER DOES NOT USE TRANSMIT INTERRUPTS.  ╘HIS IS BECAUSE
  1246. HAVING BOTH TYPES OF INTERRUPTS IS AN UGLY PROBLEM AND MAY BE TOO MUCH FOR
  1247. THE PROCESSOR TO KEEP UP WITH.  ╔NSTEAD, THE ╙╠ DRIVER USES POLLED
  1248. TRANSMISSION.  ╔N THE CONTEXT OF A TERMINAL PROGRAM, THIS IS NORMALLY NO
  1249. REAL PROBLEM, SINCE NORMALLY ONLY ONE OR A FEW BYTES ARE TRANSMITTED AT A
  1250. TIME (WITH EACH KEYSTROKE).  ╔N THE EVENT THAT ╚╞├ IS ASSERTED WHEN THE
  1251. DRIVER GOES TO TRANSMIT A BYTE, IT WILL PUT THE BYTE INTO THE TRANSMIT
  1252. BUFFER AND RETURN WITHOUT TRANSMITTING THE BYTE.  ╘HIS IS BECAUSE THE SYSTEM
  1253. WOULD DEADLOCK IF IT WAITED FOR A TRANSMIT-READY SIGNAL, SINCE IT WILL NEVER
  1254. GET ONE AS LONG AS ╚╞├ IS ASSERTED.  ├ONTROL IS RETURNED TO THE USER PROGRAM
  1255. TO CLEAR OUT THE RECEIVE BUFFER SO THAT ╚╞├ CAN BE RELEASED AND BYTES CAN BE
  1256. TRANSMITTED.  ╫HEN ╚╞├ IS RELEASED BY A "READ" SYSTEM CALL, THE ╙╠ DRIVER
  1257. WILL TRANSMIT ALL BUFFERED TRANSMIT CHARACTERS IN A POLLING LOOP BEFORE
  1258. RETURNING.  ├URRENTLY, IF THE TRANSMIT BUFFER OVERFLOWS, THE OVERFLOW
  1259. CHARACTERS ARE SIMPLY DROPPED.  ╔N THE FUTURE, THE "WRITE" CALL WILL RETURN
  1260. WITH AN ERROR WITH INFORMATION ABOUT HOW MANY CHARACTERS WERE SUCCESSFULLY
  1261. BUFFERED FOR FUTURE TRANSMISSION, SO THAT IT CAN RECOVER ON ITS OWN.
  1262.  
  1263. ╘HE DEVICE-DRIVER CODE IS FAIRLY COMPLICATED BECAUSE OF ALL THE HARDWARE
  1264. RESTRICTIONS AND RACE-CONDITION HANDLING IN THE CODE.
  1265.  
  1266. 5.7. ╙═┴╥╘_╫┴╘├╚ ─┼╓╔├┼
  1267.  
  1268. ╘HE "CONFIG" PROGRAM WILL ATTEMPT TO READ THE CURRENT TIME FROM THE
  1269. ╙MART╫ATCH DEVICE YOU HAVE PLUGGED INTO PORT #1 IF YOU SET A "TIME-DEVICE"
  1270. FIELD IN THE SYSTEM CONFIGURATION TO THE SPECIAL VALUE OF 254.  ╘HE CODE WAS
  1271. DONATED BY ╥ANDY ╫EEMS <╥ED ╚ERRING ├ORP.> (RWEEMS@EDGE.ERCNET.COM) AND HAS
  1272. BEEN INTEGRATED INTO THE CONFIGURATION PROGRAM.  ╥ANDY SAYS:
  1273.  
  1274. ╔F YOU'RE WONDERING WHAT A ╙MART╫ATCH IS...IT'S A COOL LITTLE PASS-THROUGH
  1275. SOCKET ORIGINALLY DESIGNED FOR ╨├S ╔ THINK (AND ┴PPLES) THAT GIVES YOU A
  1276. BATTERY BACKED CLOCK IN A TRANSPARENT MANNER.  ┘OU REMOVE A ╥╧═, PLUG THE
  1277. ╙MART╫ATCH INTO THE ╥╧═'S SOCKET AND PLUG THE ╥╧═ INTO THE ╙MART╫ATCH
  1278. SOCKET.  ╔F YOU HAVE A DRIVER THAT READS FROM THE ╥╧═ IN JUST THE RIGHT
  1279. SEQUENCE, THE ╙MART╫ATCH KICKS IN AND SENDS THE DATE/TIME ONE BIT AT A
  1280. TIME.  ╧F COURSE, THERE'S ALWAYS THE POSSIBILITY THAT THE ╥╧═ COULD
  1281. ACCIDENTALLY BE READ IN THE SEQUENCE THAT TRIGGERS THE ╙MART╫ATCH, BUT IT'S
  1282. EXTREMELY UNLIKELY.
  1283.  
  1284. ┴NYWAY, ╔ NEVER COULD GET IT TO WORK "PROPERLY" ON MY 128─ (BY PLUGGING IT
  1285. INTO A ╥╧═'S SOCKET), BUT ╔ FOUND PLANS FOR HOOKING IT UP TO JOYSTICK PORT 1
  1286. AND DRIVERS FOR ╟┼╧╙.  ╔T DOESN'T INTERFERE WITH THE JOYSTICK PORT OR
  1287. KEYBOARD AT ALL.
  1288. ------------------------------------------------------------------------------
  1289. 6. ├╧══┴╬─╙
  1290.  
  1291. ╘HE FOLLOWING SUBSECTIONS GIVE THE LOW DOWN ON ALL OF THE EXECUTABLE PROGRAMS
  1292. PROVIDED WITH ┴├┼, INCLUDING THE SYSTEM PROGRAMS AND EXTERNAL USER PROGRAMS.
  1293. ╞OR EACH COMMAND, A SYNOPSIS IS GIVEN, FOLLOWED BY THE DESCRIPTION.
  1294.  
  1295. 6.1. ┬╒╔╠╘-╔╬ ├╧══┴╬─╙
  1296.  
  1297. ╘HESE COMMANDS ARE BUILT RIGHT INTO THE COMMAND SHELL.
  1298. --------
  1299. ECHO [ARG ...]
  1300.  
  1301. ╨RINT THE GIVEN ARGUMENTS TO STDOUT, WITH A SPACE BETWEEN EACH AND A CARRIAGE
  1302. RETURN AT THE END OF THE LINE.
  1303. --------
  1304. CLEAR
  1305. CLS
  1306.  
  1307. ├LEAR THE SCREEN.  "CLS" IS THE ═╙-─╧╙ NAME AND "CLEAR" IS THE ╒NIX NAME.
  1308. ╘HIS COMMAND SIMPLY EMITS A "FORM-FEED" CHARACTER TO STDOUT.
  1309. --------
  1310. LS   [-HELP] [-L] [-C] [-F] [DIRNAME ...]
  1311. DIR  [-HELP] [-L] [-C] [-F] [DIRNAME ...]
  1312. D    [-HELP] [-L] [-C] [-F] [DIRNAME ...]
  1313. CLSL [-HELP] [-L] [-C] [-F] [DIRNAME ...]
  1314.  
  1315. ─ISPLAY A DIRECTORY LISTING OF THE GIVEN DIRECTORY OR OF THE CURRENT
  1316. DIRECTORY IF NO "DIRNAME" IS GIVEN.  ╘HIS COMMAND HAS SO MANY VARIANTS
  1317. BECAUSE IT IS SO USEFUL.  "DIR" CLEARS THE SCREEN BEFORE GIVING A LONG-FORM
  1318. DIRECTORY LISTING.  "D" GIVES A LONG-FORM DIRECTORY LISTING WITHOUT CLEARING
  1319. THE SCREEN.  "LS" GIVES A SHORT-FORM DIRECTORY LISTING WITHOUT CLEARING THE
  1320. SCREEN, AND "CLSL" GIVES A SHORT-FORM LISTING AFTER CLEARING THE SCREEN.
  1321.  
  1322. ╙HORT-FORM LISTINGS INCLUDE ONLY THE FILENAMES OF THE FILES IN THE
  1323. DIRECTORY, WHEREAS LONG-FORM LISTINGS INCLUDE DIRECTORY NAME, FILE
  1324. PERMISSIONS, DATE AND TIME OF LAST MODIFICATION, LENGTH (IN BLOCKS*254
  1325. BYTES), FILE TYPE, AND FILENAME.  ╧N 40-COL DISPLAYS, THE DATE AND TIME
  1326. FIELDS ARE OMITTED.
  1327.  
  1328. ╘HE "-HELP" FLAG WILL MAKE THE COMMAND PRINTS ITS USAGE INFORMATION, "-L"
  1329. WILL REQUEST A LONG-FORM LISTING, "-C" WILL REQUEST THAT THE SCREEN BE
  1330. CLEARED FIRST BEFORE SHOWING THE LISTING, AND THE "-F" FLAG WILL REQUEST
  1331. THAT THE NUMBER OF FILES AND THE TOTAL SIZE IN BYTES OF ALL THE FILES BE
  1332. DISPLAYED IN ADDITION TO THE NUMBER OF BYTES FREE ON THE DEVICE FOR A
  1333. LONG-FORM LISTING (NOTE THAT ONLY FILES ARE INCLUDED IN THE COUNT AND BYTES
  1334. DATA; DIRECTORIES ARE NOT).
  1335. --------
  1336. CD [DIRNAME]
  1337.  
  1338. ├HANGE THE CURRENT WORKING DEVICE AND DIRECTORY TO THE GIVEN DIRECTORY NAME.
  1339. ╔F NO DIRECTORY NAME IS GIVEN, CHANGE TO THE "HOME" (INITIAL) DIRECTORY.
  1340. --------
  1341. CAT [FILE ...]
  1342.  
  1343. ─ISPLAY THE CONTENTS OF THE NAMED FILES TO STDOUT.  ╔F NO FILES ARE NAMED,
  1344. THEN INPUT IS TAKEN FROM STDIN (NORMALLY THE KEYBOARD).
  1345. --------
  1346. EXIT
  1347. X
  1348.  
  1349. ┼XIT FROM THE COMMAND SHELL.  ┼╧╞ ON STDIN (NORMALLY ├ONTROL-─ FROM THE
  1350. KEYBOARD) HAS THE SAME EFFECT.  ╔F THE CURRENT COMMAND SHELL IS THE INITIAL
  1351. ONE STARTED BY THE SYSTEM (PROCESS #2), THEN ┴├┼ WILL EXIT BACK TO ┬┴╙╔├.
  1352. ╧THERWISE, THE COMMAND SHELL WILL EXIT BACK TO THE PROGRAM THAT INVOKED IT.
  1353. --------
  1354. DOS COMMAND
  1355. @   COMMAND
  1356.  
  1357. ╟IVE A ├OMMODORE-─╧╙ COMMAND TO THE CURRENT DEVICE (╧╨┼╬1,DV,15..).  ┬OTH
  1358. "DOS" AND "@" ARE EXACTLY SYNONYMOUS.
  1359. --------
  1360. PATH
  1361. PATH DIRNAME ...
  1362.  
  1363. ─ISPLAY OR SET THE PATH TO SEARCH FOR SEARCHING FOR EXTERNAL PROGRAMS.
  1364. "PATH" ALONE ON A COMMAND LINE DISPLAYS THE CURRENT SEARCH PATH, AND "PATH"
  1365. FOLLOWED BY ARGUMENTS WILL SET THE SEARCH PATH TO THE FOLLOWING ARGUMENTS.
  1366. --------
  1367. SH [-VI] [SCRIPTNAME]
  1368.  
  1369. ╔NVOKE A SUB-SHELL.  ├URRENTLY, THIS IS ACTUALLY AN EXTERNAL-COMMAND CALL.
  1370. ╔F THE "-V" FLAG (VERSION/VERBOSE) IS USED, THEN THE VERSION "BANNER" IS
  1371. PRINTED WHEN THE SHELL STARTS, AND "-I" (INITIALIZE) WILL CAUSE THE NEW
  1372. SHELL TO EXECUTE THE ".ASHRC" SHELL SCRIPT BEFORE ACCEPTING COMMANDS FROM
  1373. ITS REGULAR INPUT FILE.
  1374.  
  1375. ╔F THE "SCRIPTNAME" ARGUMENT IS SUPPLIED, THEN INPUT IS TAKEN FROM THE NAMED
  1376. FILE; OTHERWISE, INPUT COMMANDS ARE TAKEN FROM STDIN.
  1377. ------------------------------------------------------------------------------
  1378. 6.2. ╙┘╙╘┼═ ╨╥╧╟╥┴═╙
  1379.  
  1380. ACE
  1381.  
  1382. ╘HIS IS THE MAIN LOADER.  ╔T DETERMINES WHETHER IT IS RUNNING ON A 128 OR A
  1383. 64 AND THEN LOADS AND RUNS EITHER "ACE128" OR "ACE64" BELOW.
  1384. --------
  1385. ACE128
  1386. ACE64
  1387.  
  1388. ╘HESE ARE THE KERNEL PROGRAMS.
  1389. --------
  1390. CONFIG
  1391.  
  1392. ╘HE SYSTEM CONFIGURATION PROGRAM.  ╘HIS IS NOT A USER-EXECUTABLE PROGRAM; IT
  1393. IS LOADED AND EXECUTED WHILE THE SYSTEM IS BOOTSTRAPPING.  ╘HIS PROGRAM
  1394. LOADS THE ".ACERC", "ACE-CHARSET", AND "ACE-CHARSET-4BIT" FILES, INITIALIZES
  1395. THE DYNAMICALLY ALLOCATED MEMORY, AND SETS THE DATE.
  1396. --------
  1397. CONFIG.EDIT
  1398.  
  1399. ╘HE CONFIGURATION EDITOR WRITTEN IN ┬┴╙╔├.  ╠╧┴─ AND ╥╒╬ IT DIRECTLY FROM
  1400. ┬┴╙╔├.  ╞ULL-SCREEN INTERFACE.  ╙AME PROGRAM RUNS ON EITHER A 128 OR 64.
  1401. ------------------------------------------------------------------------------
  1402. 6.3. ┼╪╘┼╥╬┴╠ ╨╥╧╟╥┴═╙
  1403.  
  1404. CP [-F] FILE DESTFILE
  1405. CP [-F] FILE ... DIRECTORY
  1406.  
  1407. ┴ FILE COPIER.  ╧PERATES LIKE THE ╒NIX FILE-COPIER PROGRAM.  ╔F YOU GIVE TWO
  1408. FILENAMES, WILL COPY THE FIRST FILE TO THE SECOND NAME.  ╔F A NUMBER OF FILE
  1409. NAMES ARE GIVEN AND THE LAST ARGUMENT IS A DIRECTORY NAME IS GIVEN, WILL
  1410. COPY ALL OF THE FILES, RETAINING THEIR NAMES, INTO THE GIVEN DIRECTORY.
  1411.  
  1412. ╔F A FILE THAT YOU WANT TO COPY TO ALREADY EXISTS, THEN YOU WILL BE PROMPTED
  1413. FOR WHETHER YOU WANT TO OVERWRITE THE FILE: YES, NO, ALL, OR QUIT.
  1414. ┴NSWERING ┘ES WILL OVERWRITE THE FILE, AND CONTINUE ONTO THE NEXT FILE.
  1415. ┴NSWERING ╬O WILL ABORT COPYING THE CURRENT FILE AND CONTINUE ONTO THE NEXT
  1416. FILE.  ┴NSWERING ┴LL WILL HAVE THE SAME ACTION AS ┘ES, EXCEPT THAT IT WILL
  1417. NEVER ASK YOUR PERMISSION AGAIN; IT WILL ALWAYS ASSUME ┘ES.  ┴NSWERING ╤UIT
  1418. WILL ABORT THE ENTIRE COPY OPERATION WITHOUT DISTURBING ANY MORE FILES.
  1419.  
  1420. ╔F, ON THE OTHER HAND, YOU USE THE "-F" OPTION (FORCE), THEN THE COMMAND
  1421. WILL OVERWRITE EXISTING FILES WITHOUT PESTERING YOU FOR PERMISSION.  ╧R, IF
  1422. THE STDIN FILE STREAM IS NOT CONNECTED TO THE CONSOLE, THEN THE "FORCE"
  1423. OPTION WILL BE PRESUMED.  ╔ WOULD REALLY LIKE TO GET A "-R" (RECURSIVE)
  1424. OPTION WORKING.  ═AYBE IN AN "XCP" VARIANT.
  1425. --------
  1426. RM FILE ...
  1427.  
  1428. ╞ILE REMOVER (SCRATCHER).  ┴LL NAMED FILES WILL BE DELETED.
  1429. --------
  1430. MV OLDFILE1 NEWFILE1 ... OLDFILE╬ NEWFILE╬
  1431.  
  1432. ╞ILE RENAMER.  ╞OR EACH PAIR OF NAMES, THE OLD NAME WILL BE CHANGED TO THE
  1433. NEW NAME.  ╔F THE NEW NAME ALREADY EXISTS, THEN THE PROGRAM WILL REPORT AN
  1434. ERROR.  ╘HIS USES THE CRUFTY ├OMMODORE RENAME ─╧╙ COMMAND, SO DON'T EVEN
  1435. THINK ABOUT RENAMING A FILE THAT IS NOT IN THE CURRENT DIRECTORY OR "MOVING"
  1436. A FILE BETWEEN DIRECTORIES.
  1437. --------
  1438. MKDIR FLAT─IR╬AME
  1439.  
  1440. ├REATE A NEW SUBDIRECTORY IN THE CURRENT DIRECTORY.  ╘HE GIVEN NAME MUST BE
  1441. "FLAT", I.E., IT IS JUST THE NAME LIKE "DIRNAME", WITHOUT ANY "/"S OR ":"S.
  1442. --------
  1443. RMDIR FLAT─IR╬AME
  1444.  
  1445. ╥EMOVE AN EXISTING EMPTY SUBDIRECTORY IN THE CURRENT DIRECTORY.
  1446. --------
  1447. WC FILE ...
  1448.  
  1449. ╫ORD COUNTER.  ├OUNTS THE LINES, WORDS, AND CHARACTERS IN A FILE.  ╘O COUNT
  1450. LINES, THE PROGRAM SIMPLY COUNTS CARRIAGE RETURNS (CODE 13 DECIMAL).  ┴ WORD
  1451. IS ANY NON-WHITESPACE CHARACTER(S) BETWEEN WHITESPACE CHARACTERS.
  1452. ╫HITESPACE IS DEFINED AS THE CHARACTERS ╙╨┴├┼, ╘┴┬, AND ╥┼╘╒╥╬ (CODES 32, 9,
  1453. AND 13 DECIMAL, RESPECTIVELY).  ╔F MULTIPLE FILES ARE SPECIFIED, TOTALS WILL
  1454. BE REPORTED.
  1455. --------
  1456. GREP [-[I][V]] [^]SUBSTR[$] FILE ...
  1457.  
  1458. ╘HE "I" AND "V" FLAGS ARE OPTIONAL.  "I" MEANS TO IGNORE THE CASE OF LETTERS
  1459. IN COMPARISONS AND THE "V" MEANS TO INVERT THE SEARCH - DISPLAY LINES THAT
  1460. DO NOT MATCH THE PATTERN.
  1461.  
  1462. ╘HE SUBSTRING MAY BEGIN WITH "^" WHICH MEANS ONLY TO CHECK FOR THE STRING
  1463. AT THE BEGINNING OF A LINE, AND MAY END WITH "$" WHICH MEANS ONLY TO CHECK
  1464. FOR THE STRING AT THE END OF A LINE.  ┬OTH "^" AND "$" MAY BE USED AT THE
  1465. SAME TIME.  ╘HERE IS NO ESCAPE CHARACTER, SO YOU'LL HAVE PROBLEMS TRYING TO
  1466. SEACH FOR THE TWO ANCHOR CHARACTERS IN THE FILES.
  1467.  
  1468. ╧NE OR MORE FILES MAY BE SPECIFIED TO BE SEARCHED.  ╔F MORE THAN ONE FILE,
  1469. THEN THE NAME OF THE FILE WILL PRECEED EACH LINE PRINTED THAT MATCHES.
  1470. ╧UTPUT GOES TO STDOUT.  ╙OME EXAMPLES FOLLOW:
  1471.  
  1472. GREP HELLO HELLO_WORLD.C
  1473. GREP -V '^$' FILE1 >FILE1.NOBLANK
  1474. GREP -I CR┴I╟ ╚ACK*
  1475. GREP -IV 'THE$' FILE2
  1476.  
  1477. ╘HE FIRST EXAMPLE SIMPLY SEARCHES FOR THE STRING "HELLO".  ╘HE SECOND EXAMPLE
  1478. REMOVES ALL BLANK LINES FROM THE INPUT FILE.  ╘HE THIRD EXAMPLE SEARCHES THE
  1479. ╚ACK1, ╚ACK2, ╚ACK3, ╚ACK4, AND ╚ACK5 FILES (FOR EXAMPLE) FOR THE WORD "CRAIG"
  1480. WHICH CAN BE IN ANY CASE (EG. "├RAIG" WOULD MATCH).  ╘HE FOURTH EXAMPLE
  1481. DISPLAYS ALL LINES THAT DO NOT END WITH THE WORD "THE" IN ANY CASE (EG. THE
  1482. SECOND LINE OF THIS PARAGRAPH WOULD BE OMITTED).
  1483.  
  1484. ╙OME LIMITATIONS OF THE PROGRAM ARE: ONLY THE FIRST 2048 CHARACTERS OF A
  1485. (REALLY LONG) LINE WILL BE CONSIDERED, LINES MAY NOT CONTAIN THE CHARACTER
  1486. CODE $00, AND THE LAST LINE OF THE FILE MUST END WITH A ╥┼╘╒╥╬ (OR IT WILL BE
  1487. IGNORED).
  1488. --------
  1489. TR [-I] [-FROMSET2TOSET] FILE ...
  1490.  
  1491. ╘RANSLATE FILES FROM ONE CHARACTER SET TO ANOTHER.  ├HARACTER SETS SUPPORTED
  1492. ARE: ╨ETSCII, ┴SCII-├R╠F (═╙-─╧╙), ┴SCII-╠F (╒NIX), ┴SCII-├R, AND
  1493. ╙PEED╙CRIPT.  "FROMSET" AND "TOSET" IN THE SYNOPSIS ABOVE MAY BE ANY OF: "P"
  1494. (╨ETSCII), "A" (┴SCII-├R╠F), "AL" (┴SCII-╠F), "AC" (┴SCII-├R), "S"
  1495. (╙PEED╙CRIPT), "C" (├OMMODORE == ╨ETSCII), "U" (╒NIX == ┴SCII-╠F), OR "M"
  1496. (═╙-─╧╙ == ┴SCII-├R╠F).
  1497.  
  1498. ╘HE THE CHARACTER SET SPECIFIERS ARE SEPARATED BY THE CHARACTER "2" (MEANING
  1499. "TRANSLATE TO").  ╔F THE TRANSLATION SPECIFICATION ARGUMENT IS MISSING, THE
  1500. DEFAULT OF TRANSLATING FROM ┴SCII-├R╠F TO ╨ETSCII IS USED.  ╔NPUT IS TAKEN
  1501. FROM THE FILES AND ALL OUTPUT GOES TO STDOUT IN ORDER.
  1502.  
  1503. ┼XAMPLE:
  1504.  
  1505. TR -S2U FILE1 >FILE1.UNIX
  1506.  
  1507. ╘RANSLATE FROM ╙PEED╙CRIPT FORMAT TO ┴SCII-╠F (╒NIX) FORMAT THE CONTENTS OF
  1508. "FILE1" AND PUT INTO FILE "FILE1.UNIX".
  1509.  
  1510. ╘HE NAME "TR" IS USED (A ╒NIX UTILITY) BECAUSE THE FUNCTIONALITY OF THIS
  1511. PROGRAM WILL GROW TO INCLUDE THAT OF THE ╒NIX "TR" UTILITIY.
  1512.  
  1513. ╘HE "-I" OPTION MEANS TO DO AN "IN-PLACE" TRANSLATION.  ╔.E., THE ORIGINAL
  1514. FILE WILL BE OVERWRITTEN WITH THE TRANSLATED DATA.  ╘O ACHIEVE THIS, A
  1515. TEMPORARY FILE IS CREATED IN THE TEMPORARY DIRECTORY THAT IS THE SIZE OF
  1516. THE FINAL FILE, AND THEN REMOVED.  ═AKE SURE THAT YOUR TEMPORARY DIRECTORY
  1517. WILL HAVE ENOUGH SPACE TO DO THE TRANSLATIONS.
  1518. --------
  1519. SORT [-[I][V]] [+COLUMN] FILE ...
  1520.  
  1521. ╙ORT UTILITY.  ├URRENTLY USES A SUCKED-OUT INSERTION SORT ALGORITHM.  ╫ILL
  1522. BE EXTENDED TO USE THE "┴PPROXIMATION ╙ORT" ALGORITHM, WHICH HAS BETWEEN
  1523. ╧(╬) AND ╧(╬^2) PERFORMANCE (CLOSE TO ╧(╬) FOR RANDOM DATA).  ═AKES USE OF
  1524. DYNAMICALLY ALLOCATED MEMORY TO STORE LARGE FILES INTERNALLY.
  1525.  
  1526. ╘HE "I" AND "V" FLAGS ARE OPTIONAL.  "I" MEANS TO IGNORE CASE OF LETTER
  1527. CHARACTERS IN COMPARISONS TO DETERMINE ORDER.  ╘HE "V" FLAG MEANS TO INVERSE
  1528. THE ORDER OF SORTING (PUT INTO DESCENDING ORDER RATHER THEN THE USUAL
  1529. ASCENDING ORDER).  ╘HE +COL FIELD IS OPTIONAL, AND IF PRESENT, GIVES THE
  1530. CHARACTER POSITION OF THE START OF THE SORTING KEY.  ╘HE DEFAULT STARTING
  1531. POSITION IS 1 (THE BEGINNING OF THE LINE).  ┴ ╘┴┬ CHARACTER WILL BE
  1532. INTERPRETED AS ANY OTHER CHARACTER.
  1533.  
  1534. ╔F MULTIPLE FILES ARE SPECIFIED, THEY WILL ALL BE MERGED TOGETHER AND THEN
  1535. SORTED AS A GROUP.  ╙ORTED OUTPUT GOES TO STDOUT.  ╔F THE PROGRAM DIES IN
  1536. THE MIDDLE OF ITS OPERATION (EG. OUT OF MEMORY), ALL FILES OWNED BY THE
  1537. PROGRAM (PROCESS) WILL BE CLOSED AND ALL MEMORY ALLOCATED TO THE PROGRAM
  1538. WILL BE RECLAIMED.  ╘HIS IS ALSO TRUE FOR ALL OTHER EXTERNAL PROGRAMS, SINCE
  1539. THIS IS IMPLEMENTED IN THE KERNEL.
  1540. --------
  1541. WRAP FILE ...
  1542.  
  1543. ╘HIS IS LIKE THE CAT COMMAND, EXCEPT THAT LINES LONGER THAN 75 CHARACTERS
  1544. WILL BE WORD-WRAPPED INTO MULTIPLE LINES.
  1545. --------
  1546. DATE
  1547.  
  1548. ─ISPLAY THE CURRENT DATE.  ╘HE FORMAT IS: "┘┘┘┘/══/──-╚╚:══:╙╙.╘", IN
  1549. 24-HOUR TIME FORMAT.  ╘HIS COMMAND WILL BE EXTENDED TO DISPLAY IN "HUMAN
  1550. MODE" (EG. "╘UE-13-╩UL-1993  05:49:53 PM") AND TO ALLOW YOU TO SET THE
  1551. DATE.  ├URRENTLY, THE DATE WILL ONLY BE SET WHEN THE SYSTEM STARTS UP.
  1552. --------
  1553. FORTY
  1554.  
  1555. ╙WITCH TO THE 40-COLUMN (╓╔├) SCREEN ON THE 128.  ╘HIS ALSO SWITCHES THE
  1556. PROCESSOR INTO SLOW MODE.
  1557. --------
  1558. EIGHTY [ROWS]
  1559.  
  1560. ╙WITCH TO THE 80-COLUMN (╓─├) SCREEN ON THE 128 OR TO THE SOFT-80 SCREEN ON
  1561. THE ├64.  ╧N THE ├128, THIS WILL ALSO SWITCH THE PROCESSOR INTO ╞AST MODE
  1562. AND WILL SET THE ╓─├ SCREEN TO DISPLAY THE NUMBER OF ROWS THAT YOU REQUEST,
  1563. OR THE DEFAULT NUMBER OF ROWS (CONFIG OPTION) IF YOU DON'T SPECIFY A NUMBER
  1564. OF ROWS.
  1565. --------
  1566. READ FILE ...
  1567.  
  1568. ╞ILE READER.  ╒SEFUL ONLY FOR TESTING HOW LONG IT TAKES TO READ A FILE.
  1569. ╬O OUTPUT IS GENERATED.
  1570. --------
  1571. MEM
  1572. MEM ADDRESS
  1573.  
  1574. ─ISPLAY BYTES OF DYNAMICALLY ALLOCATED MEMORY THAT ARE STILL FREE AND THE
  1575. PROCESS ID OF THE "MEM" PROCESS.  ╔F YOU GIVE THE "ADDRESS" OPTION (A 32-BIT
  1576. HEXADECIMAL ADDRESS), THEN THE MEMORY CONTENTS FROM THE GIVEN ADDRESS
  1577. (ALIGNED ON A 16-BYTE BOUNDARY) FOR 256 BYTES ARE DISPLAYED IN AN 80-COLUMN
  1578. FORMAT.  ╒SERS WON'T NORMALLY USE THIS OPTION; IT IS INTENDED FOR
  1579. DEBUGGING.
  1580. --------
  1581. HELLO
  1582.  
  1583. ╘HIS IS JUST A DIPPY LITTLE PROGRAM THAT PRINTS OUT A "HELLO WORLD" MESSAGE.
  1584. ╔T IS INCLUDED SO PROGRAMMERS MAY EXAMINE IT AND ITS SOURCE FILE TO SEE HOW
  1585. SIMPLE ┴├┼ PROGRAMS ARE ORGANIZED.
  1586. --------
  1587. WINDOW [COLUMNS [ROWS [START├OLUMN [START╥OW]]]]
  1588.  
  1589. ╙ETS THE WINDOW SIZE.  ╔F NO ARGUMENTS ARE GIVE, IT WILL REPORT THE CURRENT
  1590. WINDOW DIMENSIONS.  ╔F ONE OR MORE ARGUMENTS ARE GIVEN, THEY WILL BE USED AS
  1591. WINDOW ARGUMENTS AS ABOVE.  ═ISSING ARGUMENTS WILL BE TAKEN FROM THE CURRENT
  1592. WINDOW'S SETTINGS.  ╙CREEN COORDINATES START AT COLUMN 0 OF ROW 0 AND GO TO
  1593. THE FULL SIZE OF THE SCREEN.  ┘OU WILL GET AN ERROR MESSAGE IF YOU TRY TO
  1594. SET UP AN ILLEGALLY SIZED WINDOW AND THE CURRENT WINDOW WILL REMAIN
  1595. UNCHANGED.  ┴FTER SUCCESSFULLY SETTING A WINDOW, IT WILL BE FILLED WITH A
  1596. CHECKERBOARD PATTERN TO INDICATE THE SIZE OF THE WINDOW.  ╩UST CLEAR THE
  1597. SCREEN TO GET RID OF THIS.
  1598. --------
  1599. CHRSET FILE
  1600.  
  1601. ╠OADS THE NAMED FILE FOR USE AS THE CURRENT CHARACTER SET.  ╘HE FILE MUST BE
  1602. A VALID ┴├┼ CHARACTER SET.
  1603. --------
  1604. KEYMAT FILE
  1605.  
  1606. ╠OADS THE NAMED FILE FOR USE AS THE CURRENT KEYBOARD TRANSLATION MATRIX.
  1607. --------
  1608. HEAD [-╬] [FILE ...]
  1609.  
  1610. ╘HIS UTILITY WAS DONATED BY ╩AKE ╚AMBY.  ╚E SAYS:  ╔T PRINTS THE TOP ╬ LINES
  1611. OF ANY FILE (OR ╙╘─╔╬ IF NO FILE IS GIVEN), WHERE ╬ DEFAULTS TO 10.  ╔T
  1612. DETECTS THE ╥╒╬/╙╘╧╨ KEY, AND PRINTS A USAGE MESSAGE IF GIVEN BOGUS
  1613. ARGUMENTS.
  1614. --------
  1615. JIF
  1616.  
  1617. ─ISPLAYS THE CURRENT JIFFY-CLOCK TIME TO STANDARD OUT.  ┴├┼'S JIFFY CLOCK
  1618. IS A 32-BIT QUANTITY.
  1619. --------
  1620. MOUSETEST [-H [-T]]
  1621.  
  1622. ╘HIS ALLOWS YOU TO MOVE CROSSHAIRS AROUND ON THE HI-RES SCREEN WITH A MOUSE
  1623. PLUGGED INTO PORT #1.  ╔F ONE ARGUMENT IS PRESENT, THEN THE REGULAR HI-RES
  1624. SCREEN IS USED (USUALLY, THE LOWEST-RESOLUTION SCREEN IS USED), AND IF TWO
  1625. ARGUMENTS ARE PRESENT, THE PROGRAM WILL PERFORM A GRAPHICS SPEED TEST (YOU'D
  1626. HAVE TO EXAMINE THE CODE TO SEE WHAT IS BEING TESTED).
  1627. --------
  1628. MORE FILE ...
  1629.  
  1630. ╞ULL-SCREEN FILE VIEWER.  ┴T THE PROMPT, PRESS ╙╨┴├┼ TO VIEW THE NEXT
  1631. SCREENFUL OF A FILE, ╥┼╘╒╥╬ OR CURSOR-─╧╫╬ TO VIEW THE NEXT LINE, ╬ TO GO
  1632. ONTO THE NEXT FILE TO BE VIEWED, OR ╙╘╧╨ OR ╤ TO EXIT THE VIEWER.  ╞UTURE
  1633. EXPANSION POSSIBILITIES INCLUDE A "GO BACK" COMMAND AND AN ┴╙├╔╔-TRANSLATION
  1634. MODE.
  1635. --------
  1636. UUENCODE FILE ...
  1637.  
  1638. ┴ UUENCODER.  ╘HE UUENCODE PROGRAM SENDS ITS OUTPUT TO STDOUT, SO YOU WILL
  1639. USUALLY WANT TO REDIRECT STDOUT TO A DISK FILE.  ╘HIS OUTPUT WILL BE IN
  1640. ╨ETSCII CHARACTERS, TO WORK WITH THE OTHER TEXT UTILITIES.  ╔F YOU WISH TO
  1641. HAVE THE OUTPUT IN ┴SCII, THEN YOU MUST RUN IT THROUGH THE "TR" PROGRAM
  1642. (BELOW).
  1643. --------
  1644. UUDECODE FILE ...
  1645.  
  1646. ┴ UUDECODER.  ╘HE UUDECODE PROGRAM WILL ACCEPT EITHER ╨ETSCII OR ┴SCII FILES
  1647. AND IS ABLE TO EXTRACT MULTIPLE FILES FROM ONE INPUT FILE.  ┼XTRACTED FILES
  1648. ARE PUT INTO ╨╥╟ FILES.
  1649. --------
  1650. BCODE [-HELP] [-V] [-U] [-M] [-L MAX_LINE_COUNT] [FILENAME ...]
  1651.  
  1652. ╙EE THE EXTERNAL DOCUMENTATION FILE "ACE╬╬-BCODE.DOC".
  1653. --------
  1654. UNBCODE [-HELP] [-I] [-V] [-D] [FILENAME ...]
  1655.  
  1656. ╙EE THE EXTERNAL DOCUMENTATION FILE "ACE╬╬-BCODE.DOC".
  1657. --------
  1658. CRC32 FILE ...
  1659.  
  1660. ├╥├32 *┬* GENERATOR.  ╘HE NUMBERS GENERATED BY THIS PROGRAM MATCH ├╥├32
  1661. VALUE GENERATED BY OTHER PROGRAMS, SUCH AS ╨╦┌╔╨ AND ┌═╧─┼═.  ╘HIS PROGRAM
  1662. IS USED TO VERIFY THAT FILES HAVE BEEN TRANSPORTED FROM PLACE TO PLACE
  1663. CORRECTLY.
  1664.  
  1665. ╘HE PROGRAM USES A TABLE-DRIVEN BYTE-ORIENTED ALGORITHM, SO IT EXECUTES
  1666. FASTER THAN THE OLDER (CRC32A) PROGRAM.
  1667. --------
  1668. CRC32A FILE ...
  1669.  
  1670. ├╥├32 *┴* GENERATOR.  ╘HE NUMBERS GENERATED BY THIS PROGRAM ─╧╬'╘ MATCH THE
  1671. ├╥├32 GENERATED BY OTHER PROGRAMS, SUCH AS ╨╦┌╔╨.  ╚OWEVER, IT WILL ALWAYS
  1672. MATCH ITSELF.  ╘HE PROGRAM USES A BRUTE-FORCE BITWISE ALGORITHM, SO IT IS
  1673. RELATIVELY SLOW.  ╘HE PROGRAM IS INCLUDED FOR HYSTERICAL (ER... HISTORICAL)
  1674. REASONS.
  1675. --------
  1676. UNKAR FILE ...
  1677.  
  1678. ╦┴╥ (╦EVIN'S ┴╥CHIVER) DEARCHIVER, INTENDED TO BE USED FOR EXTRACTING THE
  1679. ┴├┼ SOURCE CODE, ALTHOUGH YOU MAY FIND THIS ARCHIVER FORMAT USEFUL FOR YOUR
  1680. OWN PURPOSES.
  1681. --------
  1682. KAR [-HELP] FILE ...
  1683.  
  1684. ╦┴╥ ARCHIVER.  ╘HIS MAY BE USED TO ENCODE ANY TEXT FILES INTO A SINGLE ╦┴╥
  1685. ARCHIVE.  ╧NLY TEXT FILES MAY BE ARCHIVED, AND THE RESULTING ARCHIVE IS
  1686. ALSO A TEXT FILE, SO YOU CAN LOOK AT IT, MAIL IT, ETC.  ┴LL OF THE NAMED
  1687. FILES ARE INCLUDED AND OUTPUT GOES TO STDOUT, WHICH YOU WILL LIKELY WANT
  1688. TO REDIRECT.
  1689. --------
  1690. VBM [-HELP] FILE ...
  1691.  
  1692. ╘HIS IS A PORTED VERSION OF A PROGRAM (╓┬═ ┬ITMAP ╓IEWER VERSION 1.10) THAT
  1693. WAS RELEASED EARLIER AS A STAND-ALONE PROGRAM.  ╘HE PORTED VERSION HAS ALL
  1694. THE BENEFITS OF ALL ┴├┼ PROGRAMS: IT WILL RUN ON EITHER THE 128 OR 64 AND
  1695. YOU CAN CONVENIENTLY SPECIFY THE FILES YOU WANT TO USE THE PROGRAM WITH.
  1696. ┘OU WILL WANT TO GET THE IMAGE FILES AND THE ├-LANGUAGE XBM-TO-VBM CONVERTER
  1697. THAT WERE BUNDLED WITH THE ORIGINAL PROGRAM.
  1698.  
  1699. ╘HIS PROGRAM REQUIRED SOME KERNEL IMPROVEMENTS, INCLUDING ADDING BASIC
  1700. SUPPORT FOR 320*200 MONOCHROME GRAPHICS ON THE 64 AND 640*200 AND 640*491
  1701. (╬╘╙├-64╦ ONLY) USING THE ╓─├ DISPLAY OF THE 128.  ╬OTE THAT THE 320*200 AND
  1702. 640*491 DISPLAYS HAVE A PIXEL ASPECT OF 1-TO-1 AND THE 640*200 DISPLAY HAS A
  1703. PIXEL ASPECT RATIO OF 2-TO-1.  ╙INCE IMAGES ARE NORMALLY ENCODED WITH A
  1704. 1-TO-1 ASPECT RATIO, IMAGES WILL LOOK TWICE AS TALL AS THEY SHOULD ON THE
  1705. 640*200 DISPLAY.  ╘HE VBM PROGRAM DOESN'T ATTEMPT TO CORRECT THE ASPECT OF
  1706. IMAGES (YET).
  1707.  
  1708. ╫HEN YOU START THE "VBM" PROGRAM WITH IMAGE FILES SPECIFIED, IT WILL DISPLAY
  1709. THE IMAGE AND THEN WAIT FOR YOU TO PRESS A KEY.  ╨RESSING "╤" WILL EXIT FROM
  1710. THE PROGRAM.  ╨RESSING ANY OF THE CURSOR KEYS WILL SCROLL THE IMAGE A
  1711. QUARTER-SCREEN IN THE DIRECTION YOU PRESS.  ╨RESSING THE ╚╧═┼ KEY WILL
  1712. RETURN YOU TO THE "HOME" POSITION OF THE IMAGE.  ╨RESSING THE ╙╨┴├┼ ┬┴╥ OR
  1713. ╥┼╘╒╥╬ KEY WILL CAUSE THE NEXT IMAGE IN THE "SLIDE SHOW" TO BE VIEWED.
  1714. ┴FTER THE LAST IMAGE, THE VIEWER WILL EXIT.  ╧H, WHILE DISPLAYING THE
  1715. CURRENT IMAGE, THE PROGRAM WILL "PEEK" AT THE KEYBOARD BUFFER AND IF YOU
  1716. HAVE TYPED ANY KEY, IT WILL STOP DISPLAYING THE IMAGE AND INTERPRET THE
  1717. KEY.  ╘HIS WILL ALLOW YOU TO POSITION OR SELECT AN IMAGE QUICKLY.
  1718. ╘HERE ARE OTHER POSITIONING COMMANDS SUMMARIZED AS FOLLOWS:
  1719.  
  1720. ╒╨,─╧╫╬,╠┼╞╘,╥╔╟╚╘: 1/4 PAGE SCROLL
  1721. ╙╚-╥╔╟╚╘,╙╚-╠┼╞╘  : 1/2 PAGE SCROLL LEFT/RIGHT
  1722. ╙╚-╠╔╬┼╞┼┼─,╠╞    : 1/2 PAGE SCROLL UP/DOWN
  1723. ├╘-╠┼╞╘,├╘-╥╔╟╚╘  : FULL PAGE SCROLL LEFT/RIGHT
  1724. ├╘-╒╨,├╘-─╧╫╬     : FULL PAGE SCROLL UP/DOWN
  1725. I,M,J,K: SMALL SCROLL UP,DOWN,LEFT,RIGHT
  1726. 1 TO 9 : SET SMALL-SCROLL JUMP (TIMES 8, IN PIXELS)
  1727. ├╧-╠┼╞╘,├╧-╥╔╟╚╘  : GO TO END LEFT/RIGHT
  1728. ├╧-╒╨,├╧-─╧╫╬     : GO TO END UP/DOWN
  1729. ╚╧═┼   : GO TO TOP LEFT OF IMAGE
  1730. ├╠╥    : GO TO CENTER OF IMAGE
  1731. ╚┼╠╨   : DISPLAY THIS HELP INFORMATION
  1732. (BASIC KEYBOARD HAS EQUIVALENT CURSOR-MOVEMENT KEYS)
  1733.  
  1734. ╨RESSING "?" OR ╚┼╠╨ WILL BRING UP A SCREEN WITH HELP INFORMATION AND THE
  1735. NAME AND NUMBER OF THE FILE BEING VIEWED.  ╨RESSING "0" WILL TAKE YOU TO
  1736. THE FIRST IMAGE GIVEN ON THE COMMAND LINE, AND PRESSING "$" WILL TAKE YOU
  1737. TO THE LAST IMAGE ON THE COMMAND LINE.
  1738.  
  1739. ╘HE ╓┬═ CUSTOM IMAGE FORMAT IS BASICALLY A BINARY REPRESENTATION OF THE ╪┬═
  1740. FORMAT FOR ╪-WINDOWS BITMAPS, WHERE ╪┬═ GIVES ITS DATA IN ├-CODE FORMAT.
  1741. ╘HERE IS NOW A NEWER VERSION OF THE ╓┬═ FORMAT (VERSION #3; THE OLDER ONE
  1742. WAS VERSION #2), AND IT FEATURES ╥╠┼ DATA COMPRESSION, WHICH GIVES ABOUT 29%
  1743. SMALLER FILES ON AVERAGE THAN VERSION #2 DID.  ╘HE VIEWER PROGRAM CAN
  1744. ACCEPT EITHER VERSION #2 OR VERSION #3 IMAGES.
  1745.  
  1746. ╘HE "PBMTOVBM.C" FILE IN THE "ACE╬╬-USRC.KAR" ARCHIVE ├ PROGRAM THAT WILL
  1747. CONVERT A FILE FROM ╪┬═ FORMAT TO ╓┬═ FORMAT.  ╙O, ALL YOU NEED TO VIEW ANY
  1748. ARBITRARY ╟╔╞ OR ╩╨┼╟ FILE ON YOUR 128 IS A PROGRAM LIKE ╒NIX'S "XV" TO
  1749. CONVERT THE IMAGE INTO ".XBM" FORMAT, AND THEN CONVERT THAT INTO ".BM"
  1750. FORMAT.  ╘HE ┴├┼ VIEWER WILL LET YOU SCROLL AROUND IN IMAGES LARGER THAN
  1751. 640X491 (ET AL), SO YOU DON'T HAVE TO CUT THE SIZE OF LARGER IMAGES.  ╘HE
  1752. MAXIMUM IMAGE SIZE THAT "VBM" WILL HANDLE IS 2040X65535.
  1753. --------
  1754. VBMPR [-HELP] FILE
  1755.  
  1756. ╘HIS PROGRAM ONLY ACCEPTS VERSION #2 IMAGES; ╔ WILL EVENTUALLY INTEGRATE
  1757. THIS INTO THE ╓┬═ VIEWER PROGRAM ABOVE.
  1758.  
  1759. ╘HE INDICATED FILE WILL BE PRINTED, AND IF THERE ARE MULTIPLE FILES, THEY
  1760. WILL BE PRINTED ONE DIRECTLY AFTER THE OTHER.  ┴LL IMAGES ARE PRINTED FROM
  1761. THE LEFT MARGIN, AND THE PROGRAM USES THE 640 DOTS-PER-LINE GRAPHIC MODE OF
  1762. THE PRINTER.  ╘HIS WILL PRODUCE AN IMAGE THAT DOES NOT HAVE A PERFECT ASPECT
  1763. RATIO (WHICH WOULD BE 576 DPL), BUT ╔ FIGURED THAT IT WOULD BE MORE
  1764. IMPORTANT TO BE ABLE TO PRINT 640X╬ IMAGES.  ╘HE HEIGHT OF AN IMAGE IS, OF
  1765. COURSE, LIMITED ONLY BY THE AMOUNT OF PAPER THAT YOU HAVE.
  1766.  
  1767. ╫HEN RUN, THE PROGRAM WILL OPEN A CHANNEL TO YOUR PRINTER THROUGH DEVICE
  1768. "Q:" OF YOUR CONFIGURATION.  ╘HIS DEVICE SHOULD BE SET UP AS A
  1769. TRANSPARENT-MODE NON-AUTO-LINEFEED CONNECTION TO YOUR PRINTER/PRINTER
  1770. INTERFACE.
  1771.  
  1772. ╔ TESTED THE SPEED OF THE PROGRAM ON A 640X480 IMAGE, AND IT TOOK TEN
  1773. SECONDS TO INPUT THE IMAGE FROM THE RAMDISK AND OUTPUT THE PRINTER DATA TO
  1774. THE NULL DEVICE, SO THE BOTTLENECK IN THE SYSTEM FOR PRINTING IMAGES WILL
  1775. DEFINITELY BE THE SPEED OF THE CONNECTION TO YOUR PRINTER OR YOUR PRINTER
  1776. ITSELF, AND NOT THIS PRINTING PROGRAM.
  1777. --------
  1778. AS [-HELP] [-S] [-D] [FILE ...]
  1779.  
  1780. ╘HIS PROGRAM IS DESCRIBED IN THE EXTERNAL FILE "ACE╬╬-AS.DOC".
  1781. --------
  1782. TERM
  1783.  
  1784. ╘HIS PROGRAM IS DESCRIBED IN THE EXTERNAL FILE "ACE╬╬-TERM.DOC".
  1785. --------
  1786. FX [-78K] [[-B] FILE ...] [-T FILE ...]
  1787.  
  1788. ╘HIS PROGRAM IS DESCRIBED IN THE EXTERNAL FILE "ACE╬╬-FX.DOC".
  1789. --------
  1790. Z FILE
  1791.  
  1792. ╘HIS PROGRAM IS DESCRIBED IN THE EXTERNAL FILE "ACE╬╬-Z.DOC".
  1793. ------------------------------------------------------------------------------
  1794. 7. ╠┴╘┼╥, ─╒─┼
  1795.  
  1796. ╘HIS SYSTEM IS ╨UBLIC ─OMAIN ╙OFTWARE.  ╔T IS NOT REQUIRED, BUT IT WOULD BE
  1797. APPRECIATED IF PEOPLE WHO USE THIS SOFTWARE REGULARLY WOULD SEND A POSTCARD
  1798. FEATURING A PICTURE OF SOME LOCAL ATTRACTION/SCENE TO THE FOLLOWING SNAIL-
  1799. MAIL ADDRESS.  ┘OU ONLY HAVE TO DO THIS ONCE.  ┘OU CAN SEND ME MONEY TOO, IF
  1800. YOU WANT, BUT THAT IS STRICTLY OPTIONAL.  ═Y SEMI-PERMANENT ADDRESS IS:
  1801.  
  1802. ├RAIG ┬RUCE
  1803. 4-249 ├EDARBRAE ┴VE.
  1804. ╫ATERLOO, ╧NTARIO
  1805. ├ANADA, ╬2╠ 4╙8
  1806.  
  1807. ╔F YOU HAVE QUESTIONS, COMMENTS, SUGGESTIONS, OR BUG REPORTS, YOU CAN
  1808. CONTACT ME AT THE FOLLOWING E-MAIL ADDRESS.
  1809.  
  1810. ╦EEP ON ╚ACKIN'!
  1811.  
  1812. -├RAIG ┬RUCE
  1813. CSBRUCE@CCNGA.UWATERLOO.CA
  1814. "┼VERYTHING FROM ┴├┼ TO ┌┼─!"
  1815. ------------------------------------------------------------------------┼╬─---
  1816.